GM.registerMenuCommand: Difference between revisions

From GreaseSpot Wiki
Jump to navigationJump to search
(simplify)
(link to other docs)
(14 intermediate revisions by 6 users not shown)
Line 1: Line 1:
{{DISPLAYTITLE:GM_registerMenuCommand}}
As of Greasemonkey 4.0, this method has been removed.
 
* See [https://wiki.greasespot.net/index.php?title=GM_registerMenuCommand&oldid=7473 history] for older versions.
== Description ==
* See the [https://github.com/greasemonkey/gm4-polyfill GM4 Polyfill] for a Greasemonkey 4 compatible way to get similar functionality.
 
This method allows user scripts to add an item the [[Greasemonkey_Manual:Monkey_Menu#The_Menu|User Script Commands]] menu.
 
Compatibility: [[Version_history#0.2.5|Greasemonkey 0.2.5+]]
 
== Syntax ==
 
{{Function|GM_registerMenuCommand|caption, commandFunc, accelKey, accelModifiers, accessKey}}
 
=== Arguments ===
 
; <code>caption</code>
: <code>String</code> The caption to display on the menu item.
; <code>commandFunc</code>
: <code>Function</code> The function to call when this menu item is selected by the user.
; <code>accelKey</code>
: <code>String</code> '''Details/verification needed!''' A single character or keycode that can trigger the command.
; <code>accelModifiers</code>
: <code>String</code>  '''Details/verification needed!''' A string listing modifiers that must be pressed with the <code>accelKey</code>. If there's more than one, then they should be separated with spaces. Available modifiers are: shift, alt, meta, control, and accel.
; <code>accessKey</code>
: <code>String</code>  '''Details/verification needed!''' A single character that can be used to jump to the command when the menu is open. It should be a letter in the <code>caption</code>.
 
== Returns ==
 
<code>undefined</code>
 
== Examples ==
 
<pre class='sample'>GM_registerMenuCommand("Hello, world (simple)", helloSimple);</pre>
 
<pre class='sample'>GM_registerMenuCommand("Hello, world!", hello, "e", "control", "h");</pre>
 
<pre class='sample'>GM_registerMenuCommand("Hello, world! (again)", hello2, "e", "shift alt", "w");</pre>
 
[[Category:API_Reference|R]]

Revision as of 15:22, 14 November 2017

As of Greasemonkey 4.0, this method has been removed.

  • See history for older versions.
  • See the GM4 Polyfill for a Greasemonkey 4 compatible way to get similar functionality.