TDBCheckBox.ValueUnchecked property
String representation for the check box value when the control is in its unchecked state.
Declaration
property ValueUnchecked: string read FValueUnchecked write SetValueUnchecked stored NonDefaultValueUnchecked;Description
ValueUnchecked is a
String property with the value for
the control when its State property contains the value cbUnchecked (or
Checked is set to
False). It is the string representation for the
boolean value, like: 'False' or '0'.
The default value for the property is assigned in the constructor, and contains the value returned from BoolToStr(False). 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.
ValueUnchecked is not written using the LCL resource streaming mechanism if a non-default value has not been explicitly assigned to the property.
ValueUnchecked 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.
ValueUnchecked 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 False (State is cbUnchecked).
Use ValueChecked to specify the string used for the checked state in the control.
Modified in version 3.0 to include the storage specifier for the property value.
See also
An experiment, built from development snapshots. Not the official Free Pascal or Lazarus documentation.