| [Overview][Constants][Types][Classes][Procedures and functions][Index] |
String representation for the check box value when the control is in its checked state.
Source position: dbctrls.pp line 718
published property TDBCheckBox.ValueChecked : string |
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.
|
Constructor for the class instance. |
|
|
The check, unchecked, or grayed state for the control. |
|
|
GetFieldCheckState - returns the check box state for the current field. |
|
|
Updates the control display value when the linked dataset is changed. |
|
|
UpdateData - examines the State to see whether it has changed. |
|
|
String representation for the check box value when the control is in its unchecked state. |
|
| Version 4.0 | Generated 2025-05-03 | Home |