SetItemState Method (TREEVIEW)

8.7, PLBCMP GUI Only

The SetItemState method alters the current state flags, overlay image index, and state image index for a specified item or row in a TREEVIEW object. The method uses the following format:

Where:

label

Optional. A Program Execution Label.

object

Required. A TREEVIEW object that is accessed.

return

Optional. A Numeric Variable that is always zero (0).

item

Required. A decimal number or Numeric Variable that indicates the handle of the item within the object to access.

state

Required. A numeric value whose integer bit map settings identify the state member bits that are set.

statemask

Optional. A numeric value whose integer bit map mask identifies the state member bits that are valid.

Flags Affected: EOS, OVER, ZERO

Note the following:

1. If the value returned is zero, the ZERO Condition Flag is set.

2. The OVER and ZERO Condition Flags are always cleared.

3. The descriptions of the {state} and {statemask} are the same as specified in the GetItemState method.

4. For improved performance in the Application Server environment, do not specify the optional return value and parameters unless needed.

See Also: Method Syntax, TREEVIEW Methods