enable menu

Enables a menu or menu item so that it can be chosen by the user.

# Metadata

Platforms: desktop, server OS: mac, windows, linux Introduced: 1.0 Security:

# Syntax

enable [menuItem itemNumber of] menu {menuName | menuNumber}

# Params

- itemNumber : The number of a menu item, from top to bottom of the menu. The first menu item is numbered 1. (Horizontal lines count.) - menuName : The name of a menu in the current menu bar. - menuNumber : The number of a menu, from left to right. - button : Any button.

# Examples

enable menu 2

enable menuItem 3 of menu "Text" -- menu in menu bar

enable menuItem 4 of button "Edit"

# Description

Use the enable menu command to enable a menu or menu item so it can be chosen.

If a menuItem is specified, only that menu item is enabled; otherwise, the entire menu is enabled.

When used to enable an entire menu at once, the enable menu command applies only to menus in the current menu bar. To disable a menu associated with a button, use the enable 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 ( at the beginning of the line for that menu item. When used to enable a menu item, the enable menu command removes the open parenthesis from the beginning of the specified line.

# Tags

# See

- **keyword:** menu, button - **property:** enabled, disabled - **command:** enable, doMenu - **function:** menus - **glossary:** property, command, menu item, menu bar