Skip to main content

TcxCustomColorComboBoxProperties Class

Holds specific settings of color combo box controls.

Declaration

TcxCustomColorComboBoxProperties = class(
    TcxCustomComboBoxProperties
)

Remarks

Settings specific to color combo box controls can be accessed using their Properties property. This property is represented by the TcxCustomColorComboBoxProperties object and its properties and events can be used to customize the color combo box.

Since the TcxCustomColorComboBoxProperties class is derived from TcxCustomComboBoxProperties, it provides you a number of properties and events to customize the behavior and appearance of the dropdown window. For instance, you can customize the width of the dropdown window and the number of items displayed within it. Please refer to the TcxCustomComboBoxProperties class description for details.

Additionally, the TcxCustomColorComboBoxProperties class introduces a number of properties and events specific to the color combo box. For instance, you can change the alignment, width and border color of color boxes displayed within each item (the ColorBoxAlign, ColorBoxWidth and ColorBoxFrameColor properties). Also, you can specify the appearance and behavior of the control when no color is selected (the ColorComboStyle, DefaultColor, DefaultColorStyle and DefaultDescription properties).

You can specify the naming conventions for colors and their display format when they have no appropriate name in the current naming convention (the NamingConvention and ColorValueFormat properties, the OnNamingConvention event). If you want to allow end-users to select custom colors and add them to the list, you can set the AllowSelectColor property to True and handle the OnSelectCustomColor event as needed. You can also control the number of the most recently used colors displayed within the drop down using the MaxMRUColors property. Adding and deleting colors from the most recently used list can be controlled by handling the OnAddedMRUColor and OnDeletedMRUColor events.

Do not create instances of the TcxCustomColorComboBoxProperties class directly. It is automatically created when a color combo box control initializes its Properties property. The TcxCustomColorComboBoxProperties class can be used to derive your own class holding editor specific properties.

See Also