DISABLEITEM

7.8.5, PLBCMP GUI Only

The DISABLEITEM instruction prohibits events for a specified object. The item is still visible to the user but is dimmed. The instruction uses the following format:

Where:

label

Optional. A Program Execution Label.

object

Required. A previously defined and created object or pointer to an object that is disabled.

item

Optional. A Numeric Variable, numeric literal, or Expression that indicates the item within the object that is disabled.

Flags Affected: NONE

Note the following:

1. If {item} is not specified, the default item number of zero is used.

2. The entire object is disabled if an item number of zero is used and the object is not a DIALOG object.

3. Only DIALOG, FLOATMENU, MENU, and SUBMENU objects may have individual items disabled.

4. No action occurs if the item number is not valid or the item is already disabled.

5. An object must be CREATEd before using DISABLEITEM. If this is not done, a runtime error of O105 is generated.

See Also: Example Code, ENABLEITEM, Object Instructions