Skip to main content

TcxCustomCheckGroup.States Property

Specifies check states for individual check boxes.

Declaration

property States[Index: Integer]: TcxCheckBoxState read; write; default;

Property Value

Type
TcxCheckBoxState

Remarks

Use the States property to obtain or change the check state of an individual item within the group. The item whose state is to be returned or modified is specified by its index via the Index parameter. The first item’s index is zero. The last item’s index is the number of items decremented by one. Specifying an invalid item index will raise an exception.

Note that the grayed state availability is controlled by the Properties.AllowGrayed property. However, you can set a check box’s state to grayed via code regardless of that property’s value.

Setting this property at design time invokes the “cxCheckGroup – CheckStates editor“ which helps you customize the check states of items.

Note

Use the CalculateCheckStatesValue and CalculateCheckStates methods to calculate the editor’s edit value by the items’ check states and vice versa.

See Also