Skip to main content

DevExpress v24.2 Update — Your Feedback Matters

Our What's New in v24.2 webpage includes product-specific surveys. Your response to our survey questions will help us measure product satisfaction for features released in this major update and help us refine our plans for our next major release.

Take the survey Not interested

TcxTreeListNode.CheckState Property

Specifies the node’s checked state.

#Declaration

Delphi
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).

See Also