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

# TCheckBox.Checked

Indicates the checked state for the control as a Boolean value.

## Declaration

Source position: stdctrls.pp line 1383

`published property TCheckBox.Checked : Boolean;`

## Description

Checked is a Boolean property which indicates if the control is displayed using its "checked" or "unchecked" state. The default value for the property is False and indicates the control uses its unchecked state.

Checked is a published property in TCheckBox and uses the overridden read and write access specifiers from TCustomCheckBox (GetChecked and SetChecked). The property value is read from and written to the State property using one of the TCheckBoxState enumeration values. For example:

State value | Checked value
cbUnchecked | False
cbChecked | True
cbGrayed | The value in Checked is not significant.

Changing the value in Checked causes State to be updated with the corresponding TCheckBoxState value, which in turn, calls either the Click method or the OnChange event handler.

See State and ClicksDisabled for more information.

## See also

TCheckBox.State |  | The check, unchecked, or grayed state for the control.
TCheckBox.Action |  | The Action associated with the control.
TCheckBox.OnClick |  | Notification handler for mouse clicks.
TCheckBox.OnChange |  | Event handler signalled when the button control is clicked.
TCustomCheckBox.GetChecked |  | Gets the value for the Checked property.
TCustomCheckBox.SetChecked |  | Sets the value for the Checked property.
TCheckBoxState |  | Represents the states for a check box.
TButtonControl.Checked |  | Indicates the checked state for the control as a Boolean value.
TButtonControl.ClicksDisabled |  | Disables calling the Click method without changing the Enabled state for the control.
TButtonControl.Click |  | Performs actions needed when a click message is handled for the control.
TButtonControl.DoOnChange |  | Signals the OnEditingDone and OnChange event handlers (when assigned).