| [Overview][Constants][Types][Classes][Procedures and functions][Index] |
String representation for the check box value when the control is in its unchecked state.
Source position: dbctrls.pp line 719
published property TDBCheckBox.ValueUnchecked : string |
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).
| Remark: | The property value is not included in the LCL resource streaming mechanism if a non-default value has not been explicitly assigned to the property. |
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.
|
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 checked state. |
|
| Version 4.0 | Generated 2025-05-03 | Home |