TcxTreeListNode.CheckState Property

Specifies the node’s checked state.

Declaration

property CheckState: TcxCheckBoxState read; write;

Property Value

Type
TcxCheckBoxState

Remarks

Along with the checked and unchecked states, this property also allows you to specify the control’s grayed state, regardless of the AllowGrayed property setting. A node indicates its checked state using a control set by the parent node‘s CheckGroupType property. If no control is set (the CheckGroupType property is set to ncgNone), the CheckState property always returns cbsUnchecked. Refer to the TcxCheckBoxState type description for details on available control states.

A parent node keeps track of child states, and automatically changes its state to unchecked (if the two-state mode is enabled) or grayed (if the three-state mode is enabled), if one of its checked children has been unchecked or grayed. To respond to changes made to the checked state and, optionally, discard them, handle the tree list’s OnNodeCheckChanging and OnNodeCheckChanged events.

Note

A parent node’s CheckState property value is not automatically updated when any of the following takes place:

• A parent node’s CheckGroupType property value is changed.

• A parent node’s collection of child nodes is changed (for instance, by adding or removing child nodes).