CHECKITEM

7.8.5, PLBCMP GUI Only

The CHECKITEM instruction sets or clears a check mark beside an item in a FLOATMENU, MENU, or SUBMENU object. The instruction uses the following format:

Where:

label

Optional. A Program Execution Label.

object

Required. A previously defined and created menu object or menu object pointer within which a check mark is placed.

item

Required. A Numeric Variable, Expression, or decimal constant indicating the item number beside which the check mark is placed or removed.

state

Required. The keyword ON or OFF indicating the state of the check mark.

Flags Affected: NONE

Note the following:

1. If the {state} keyword is ON, the CHECKITEM instruction places a check mark beside the menu item indicated by the {item} operand. If there was already a check mark beside the item, nothing is done.

2. If the {state} keyword is OFF, the CHECKITEM instruction clears a check mark beside the menu item indicated by the {item} operand. If there was no check mark beside the item, nothing is done.

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

4. If insufficient memory is available to perform the operation, a runtime error of O106 is generated.

See Also: Example Code, Object Instructions