TcxCheckComboBox Class

An unbound combo box editor that can display items with check boxes.

Declaration

TcxCheckComboBox = class(
    TcxCustomCheckComboBox
)

Remarks

The TcxCheckComboBox class implements an unbound check combo box editor that consists of an edit box and a check list displayed in a drop-down window. Users can click check boxes in the list to select any number of items. All checked items are displayed in the edit box.

VCL Editors Library: A Check Combo Box

To manage check combo box items, use the Properties.Items property.

Main API Members

The list below outlines key members of the TcxCheckComboBox class that allow you to configure check combo box editors.

Customize editor appearance and behavior settings (Properties).
Specify an external source of check combo box settings (RepositoryItem).
Disable or enable the check combo box editor (Enabled).
Set check states for individual items (States).
Specify all item check states as one value (EditValue).
Uncheck all items (Clear).
Specify if the editor or its drop-down window has focus (Focused).
Customize the check combo box editor’s general look & feel settings (LookAndFeel).
Define appearance styles for different editor states (Style, StyleDisabled, StyleFocused, StyleHot, and Styles).
Restore the default style attributes (RestoreStyles).
Identify appearance and behavior settings applied to the check combo box (ActiveProperties).
Prevent users from changing item check states (OnEditing).

Check States and Edit Values

Call CalculateCheckStatesValue and CalculateCheckStates global functions to convert a check combo box editor’s edit value into an array of item check states and vice versa.