TcxCustomCheckListBox.EditValue Property

An overall value representing the state of all the check list box’s items.

Declaration

property EditValue: TcxEditValue read; write;

Property Value

Type
TcxEditValue

Remarks

The EditValue property specifies an integer number representing the combined state of all items within the check list box. Each bit in the edit value defines the state of the corresponding item in the Items collection. The first bit corresponds to the first item. If it is set to 0, the first item is unchecked, i.e. the Items[0].State statement returns cbsUnchecked. Otherwise, the item is checked and the Items[0].State statement returns cbsChecked. Similarly if you change the state of a particular item, the corresponding bit in the edit value is automatically toggled.

You cannot change the edit value if the AllowGrayed property is set to True. In this case, you can only change an item’s state via its State property.

If an item is set to grayed, the corresponding bit in the edit value is set to 0.

Suppose that the EditValue is set to 10, i.e. 1010 in binary notation. The second and the fourth items will be displayed checked and other items are unchecked.

Note

This property is obsolete.** Do not use the EditValue property to set the states of the check list box’s items at design time, set their State properties instead.