[Overview][Constants][Types][Classes][Procedures and functions][Index] | Reference for unit 'DBCtrls' (#lcl)

# TDBCheckBox.ValueChecked

String representation for the check box value when the control is in its checked state.

## Declaration

Source position: dbctrls.pp line 718

`published property TDBCheckBox.ValueChecked : string read FValueChecked write SetValueChecked stored NonDefaultValueChecked;`

## Description

ValueChecked is a String property with the value for the control when its State property contains the value cbChecked (or Checked is set to True). It is the string representation for the boolean value, like: 'True', '1', or -1'.

The default value for the property is assigned in the constructor, and contains the value returned from BoolToStr(True). Changing the value for the property causes the DataChange method to be called. This updates the control State after the new property value has been assigned to its member.

ValueChecked is not written using the LCL resource streaming mechanism if a non-default value has not been explicitly assigned to the property.

ValueChecked is used in the GetFieldCheckState method when the control is linked to a field that is not a Boolean field type. It provides the value which is compared to the field value to determine the checked State for the control.

ValueChecked is also used in the UpdateData method when the control is linked to field that is not a Boolean field type. It provides the value that is stored in the field when the Checked property is True (State is cbChecked).

Use ValueUnchecked to specify the string used for the unchecked state in the control.

## Version info

Modified in version 3.0 to include the storage specifier for the property value.

## See also

TDBCheckBox.Create |  | Constructor for the class instance.
TDBCheckBox.State |  | The check, unchecked, or grayed state for the control.
TDBCheckBox.GetFieldCheckState |  | GetFieldCheckState - returns the check box state for the current field.
TDBCheckBox.DataChange |  | Updates the control display value when the linked dataset is changed.
TDBCheckBox.UpdateData |  | UpdateData - examines the State to see whether it has changed.
TDBCheckBox.ValueUnchecked |  | String representation for the check box value when the control is in its unchecked state.
SysUtils.BoolToStr
SysUtils.TrueBoolStrs