Lingo Dictionary > D-F > enabled |  |

enabled

Syntax

    the enabled of menuItem whichItem of menu whichMenu

Description

Menu item property; determines whether the menu item specified by `whichItem` is displayed in plain text and is selectable (`TRUE,` default) or appears dimmed and is not selectable (`FALSE`).

The expression `whichItem` can be either a menu item name or a menu item number. The expression `whichMenu` can be either a menu name or a menu number.

The enabled property can be tested and set.

Note: Menus are not available in Shockwave

Example

This handler enables or disables all the items in the specified menu. The argument `theMenu` specifies the menu; the argument `Setting` specifies `TRUE` or `FALSE`. For example, the calling statement `ableMenu (`"`Special`"`, FALSE)` disables all the items in the Special menu.

    on ableMenu theMenu, vSetting
    	set n = the number of menuItems of menu theMenu
    	repeat with i = 1 to n
    		set the enabled of menuItem i of menu theMenu to vSetting
    	end repeat
    end ableMenu

See also

`name (menu property)`, `number (menus)`, `checkMark`, `script`, `number (menu items)`