Action Statement

Change the selectability of an object or item.

For Objects:

{enable|disable} {OBJECT_NAME|CLASS_NAME}

For Items:

{enable|disable} item

{ITEM_NAME [from AB_NAME]|ITEM_CLASS_NAME}

in {REG_NAME|REG_CLASS_NAME}

OBJECT_NAME

The identifier for an object.

CLASS_NAME

The identifier for a class of objects.

ITEM_NAME

The identifier for a pulldown, choice, or button.

from AB_NAME

The identifier for an action bar template. You must specify the action bar name if more than one template contains an item of the given name. Do not specify it if the item was defined outside of an action bar template.

ITEM_CLASS_NAME

The identifier for an item class containing a group of items you want enabled or disabled.

REG_NAME

The identifier for the region containing the item.

REG_CLASS_NAME

The identifier for a class of regions.

Description

The enable keyword makes the object or item selectable if all its ancestors are enabled; the disable keyword makes it not selectable.

A push button, radio button, check box, static text object, entry field, pulldown, button, or choice appears grayed when disabled.

A separator cannot be enabled.

Only the items specified in region REG_NAME are enabled or disabled. If you specify REG_CLASS_NAME, the specified items from the regions in the class are enabled or disabled.

Disabling an object implicitly disables its children.

Example

 

response to Little

 enable Big

 

response to Big

 disable Little in Size

 

response to item Open_MC from FileActionBar_AB in MainRegion_GR

 enable item SaveAsIs from FileActionBar_AB in MainRegion_GR

 

response to item Close_MC from FileActionBar_AB in MainRegion_GR

 disable item FileItems from FileActionBar_AB in MainRegion_GR

See Also

enabled and disabled Attribute Definitions

selectability of Object Inquiry Built-in Function