GM.registerMenuCommand: Difference between revisions
+z$8frZdyL%68pSU/:>w<:E3.lG-!XIB |
m Reverted edits by 222.221.75.56 (talk) to last revision by Arantius |
||
| Line 1: | Line 1: | ||
{{DISPLAYTITLE:GM_registerMenuCommand}} | {{DISPLAYTITLE:GM_registerMenuCommand}} | ||
== Description == | |||
This method allows user scripts to add an item to the [[Greasemonkey_Manual:Monkey_Menu#The_Menu|User Script Commands]] menu. | |||
Compatibility: [[Version_history#0.2.5|Greasemonkey 0.2.5+]] | |||
== Syntax == | == Syntax == | ||
Revision as of 18:27, 10 September 2011
Description
This method allows user scripts to add an item to the User Script Commands menu.
Compatibility: Greasemonkey 0.2.5+
Syntax
function GM_registerMenuCommand( caption, commandFunc, accessKey )
Arguments
captionStringThe caption to display on the menu item.commandFuncFunctionThe function to call when this menu item is selected by the user.accessKeyStringA single character that can be used to select command when the menu is open. It should be a letter in thecaption. [1]
History
In Greasemonkey 0.9.2, this API was changed.
Previously, it accepted five parameters including accelKey and accelModifiers which have been removed.
See this page's history for a description of them.
If a script passes all five parameters, in the old style, then the fifth argument is used for accessKey.
Returns
undefined
Examples
GM_registerMenuCommand("Hello, world (simple)", helloSimple);
GM_registerMenuCommand("Hello, world!", hello, "h");
GM_registerMenuCommand("Hello, world! (again)", hello2, "e", "shift alt", "w");
The last example is in the pre-0.9.2 format. The 4th and 5th arguments will be ignored in recent versions of Greasemonkey.
See Also
The GM_config @require library can handle many of the tasks that GM_registerMenuCommand is otherwise used for, in a more user-friendly manner.
