The Property
Three-state allows:
- Find out whether an option found in a check box supports 3 states (checked, unchecked or undefined) or 2 states (checked or unchecked).
Versions 16 and laterFind out whether a treeview control supports 3 states (checked, unchecked or undefined) or 2 states (checked or unchecked)
New in version 16Find out whether a treeview control supports 3 states (checked, unchecked or undefined) or 2 states (checked or unchecked)
- Modify the type of an option found in a check box: option with 3 states or with 2 states.
Remark: If the option supports the three states, it can take for value:
- 0: the option is unchecked
- 1: the option is checked
- -1: the option is undefined (grayed)
At runtime, if the option supports three states, a first click performed on an unchecked option will check it and a second click will give it an unspecified value.
Caution: A WLanguage error occurs if an option that supports 2 states takes -1 for value. Similarly, a WLanguage error occurs if a 3-state option initialized to -1 is changed into a 2-state option.
Versions 15 and later New in version 15
// Defines an unspecified option
CBOX_CheckBox1[1].TriState = True
CBOX_CheckBox1[1] = -1
Syntax
Finding out whether an element supports three states Hide the details
Result> = <Element name>.TriState
<Result>: Boolean
- True if the option supports three states,
- False otherwise.
<Control used>: Control name
Name of control to use: - Option of the Check Box control. The following syntax must be used: <Name of Check Box control>[<Option number>].
Versions 16 and laterTreeView control.
New in version 16TreeView control.
TreeView control.
Managing the three states of an option in a Check Box control Hide the details
Check Box control>[<Option number>].TriState = <Management mode
<Check Box control>: Control name
Name of Check Box control to use.
<Option number>: Integer
Number of the option to use.
<Management mode>: Boolean
- True to manage the three states,
- False otherwise.
Remarks
The Property
TriState applies only to:
- the options of a Check Box control.
Versions 16 and laterthe TreeView controls (in read-only).
New in version 16the TreeView controls (in read-only).
the TreeView controls (in read-only).