Class: MenuItem

Constructor

new MenuItem(textopt)

Constructor for Menu, MenuItem, CheckBoxMenuItem, and RadioButtonMenuItem.

Parameters:

Name	Type	Attributes	Description
`text`	string	<optional>	Text displayed in the menu item

Classes

MenuItem

Methods

keyboardShortcut(keys)

Sets keyboard shortcut (accelerators) to menu item type of components: MenuItem, CheckBoxMenuItem, RadioButtonMenuItem. See examples below. Allows to activate the menu item action using specified keyboard key combination on keyboard. This shortcut is usually display in the right side of the mnu item's text.

Parameters:

Name	Type	Description
`keys`	string	Key combination as a string. See example how to construct it.

Returns:

String Description of keyboard shortcut

Example

Modifiers: CTRL|CONTROL|SHIFT|ALT|ALTGRAPH|META

Keys: A-Z|0-9|NUMPAD[0-9]|SPACE|INSERT|ESCAPE|F[1-24]|TAB|ADD|SUBTRACT|DELETE|BACK_SPACE|BACK_SLASH|
BRACELEFT|BRACERIGHT|OPEN_BRACKET|CLOSE_BRACKET|SEMICOLON|COMMA|CAPS_LOCK|BACK_QUOTE|MINUS|PERIOD|
UP|DOWN|RIGHT|LEFT|MULTIPLY|DIVIDE|NUM_LOCK|HOME|END|PAGE_UP|PAGE_DOWN|PAUSE|SCROLL_LOCK|WINDOWS|
CONTEXT_MENU|DECIMAL|ENTER

Example key combinations: CTRL+Q, ALT+F1, CTRL+SHIFT+5, CTRL+N4, META+SHIFT+6, DELETE+SHIFT, SHIFT+UP, CTRL+OPEN_BRACKET, ATL+DOWN

menuItem1.keyboardShortcut("CTRL+Q");
menuItemUP.keyboardShortcut("SHIFT+NUMPAD[8]");

mnemonic(keyopt) → {string|MenuItem}

Gets or sets the mnemonic (keyboard shortcut key) for menu item type of components: Menu, MenuItem, CheckBoxMenuItem, RadioButtonMenuItem. Its not same as setting keyboardShortcut(...). A mnemonic allows users to activate the menu item using the keyboard (typically Alt + key).
NOTE: Not all systems and UIs show underline under mnemonic character. Some systems only show it after Alt key was pressed.

Parameters:

Name	Type	Attributes	Description
`key`	string	<optional>	A single character representing the mnemonic key (case-insensitive). If omitted, acts as a getter.

Returns:

If called without arguments, returns the current mnemonic key. If a key is provided, sets the mnemonic and returns this MenuItem instance.

Type:: string | MenuItem

Example

menuItem.text("Quit").mnemonic("q"); // Makes letter Q to be used as the keyboard shortcut key

open(positionopt, invokeropt) → {MenuItem}

Opens this menu item and all of its parent menus or context menu.

Parameters:

Name	Type	Attributes	Default	Description
`position`	object	<optional>	null	Example: {x: 100, y: 100}. Use only when root ancestor of this item is ContextMenu, to specify position where to position the ContextMenu. If invoker is specified, then position is relative to position of invoker component, otherwise it's a screen position.
`invoker`	object	<optional>	null	Used to set invoker if the context menu isn't assigned to any object and you want to be able to get invoker by using "invoker" getter.

Returns:

Returns this MenuItem instance.

Type:: MenuItem