TcxCustomCheckBox Class

Serves as the base class for classes that implement check box controls.

Declaration

TcxCustomCheckBox = class(
    TcxCustomEdit
)

Remarks

A check box control allows selecting an option. A user can check, uncheck or choose a “grayed” state. The TcxCustomCheckBox control provides the Checked and State properties by which you can control the editor state. The Checked property is of Boolean type and can identify only checked and unchecked states. The State property is more powerful and allows you to select one of the three states.

The Properties member provides many settings controlling the look & feel of check box editors. It specifies the check box alignment, images displayed instead of the check box and many other settings. Properties also contains an AllowGrayed member which determines whether a check box can have three states.

It is possible to associate a variant value with each check box state. These values are retrieved by the EditValue property from the corresponding members of the Properties object. EditValue returns values of the ValueChecked, ValueUnchecked and ValueGrayed members for checked, unchecked and grayed states, respectively.

Do not create instances of the TcxCustomCheckBox class. Use its descendants such as TcxCheckBox or TcxDBCheckBox instead.