TDBCheckBox.ValueChecked property
String representation for the check box value when the control is in its checked state.
Declaration
property 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.
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.