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

TcxCustomCheckBoxProperties.ValueUnchecked Property

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

#Declaration

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

See Also