disable menu | ||||||||||||||||
Type | command | |||||||||||||||
Dictionary | LCS | |||||||||||||||
Library | LiveCode Script | |||||||||||||||
Syntax |
| |||||||||||||||
Summary | Dims a menu or menu item so that it no longer responds to user actions. | |||||||||||||||
Introduced | 1.0 | |||||||||||||||
OS | mac, windows, linux | |||||||||||||||
Platforms | desktop, server | |||||||||||||||
Parameters |
| |||||||||||||||
Example |
| |||||||||||||||
Related | Keyword: menu, button Property: disabled Command: disable Function: menus Glossary: property, command, menu item, menu bar, prepend | |||||||||||||||
Description | Use the disable menu command to dim a menu or menu item in the menu bar, preventing the menu item from being chosen. If a menuItem is specified, only that menu item is disabled;
otherwise, the entire menu is disabled. The disable menu command
inserts an open parenthesis When used to disable an entire menu at once, the disable menu command applies only to menus in the current menu bar. To disable a menu associated with a button, use the disable command. On Mac OS systems, the Apple menu does not have a number and cannot be enabled or disabled. Menu numbering starts with the menu to the right of the Apple menu. Since a LiveCode menu bar is implemented as a group of buttons (one
button per menu, with the menu items as lines in the button's text
property), you can indicate a menu by specifying its button.
Disabled menu items have an open parenthesis Example of disabling a sub menu item using an open parenthesis:
The menu item "Sub2" will be disabled. | |||||||||||||||
Tags | menus |