2.342 .state

The .state attribute defines the activation state of a tristate checkbox.

Definition

  • Data type

    enum

  • Access

    get, set

  • changed event

    yes

  • C

    Identifier: AT_state

    Data type: DT_enum

  • COBOL

    Identifier: AT-state

    Data type: DT-enum

  • Classification

    object-specific attribute

  • Objects

    checkbox

Value range

state_unchecked

Normal state – the object is not activated; corresponds to .active := false.

state_checked

The object is activated.

state_indeterminate

The object is in an indeterminate state; in this case .active is not defined (false).

Only possible when .style = 3.

The setting of the attribute .state is also possible when .style = 2; in this case state_ indeterminate is interpreted as state_unchecked. Thus .active is also switched.

If a tristatebutton is switched into a checkbox by allocating a value, the attribute .active is always false.