TcxCustomCheckBoxProperties.ValueUnchecked Property

Specifies the value that the EditValue property returns when in the unchecked state.

Declaration

property ValueUnchecked: TcxEditValue read; write;

Property Value

Type
TcxEditValue

Remarks

If the check box editor is in the unchecked state, the EditValue property returns the value defined by the ValueUnchecked member. For other check box states, the EditValue property returns ValueGrayed or ValueChecked.

A data-aware check box editor (the TcxDBCheckBox control) posts a ValueChecked, ValueUnchecked or ValueGrayed property value in the case of the corresponding state (checked, unchecked or grayed). Conversely, when the data-aware check box editor retrieves data from the dataset, it is set to one of the abovementioned states:

• the checked state if the field specifies the ValueChecked property value;

• the unchecked state if the field specifies the ValueUnchecked property value;

• the grayed state if the field identifies neither the ValueChecked nor the ValueUnchecked property value.

The default value of the ValueUnchecked property is False (a Boolean value).

Note

The ValueUnchecked property does not accept a NULL value to avoid conflicts with ValueGrayed default value processing.