TcxCustomImageComboBox Class

Serves as the base class for the editors displaying a list of images and text strings within a dropdown window.

Declaration

TcxCustomImageComboBox = class(
    TcxCustomComboBox
)

Remarks

This class is the base class for the TcxImageComboBox class and for the user-defined classes representing the “image “editors. These “image” editors contain a list of images with corresponding text descriptions within a dropdown window. It provides properties and methods defining the basic functionality of image combo box editors.

An image combo box editor enables you to display a list of items within its dropdown window. The list of items is accessible via the Items collection of the Properties object. You should use the Items collection to assign every item a unique value via the item’s Value property. The editor uses item values to distinguish items from each other. If you do not assign the item’s Value property, the editor will not work properly.

Every item can be associated with an image and a text string displayed in the dropdown window and in the edit field of the control. The item’s ImageIndex property determines the index of the image associated with the item in the image collections provided by the Properties.Images and Properties.LargeImages properties. Thus you should populate image collections with images and then assign the required image index to the item’s ImageIndex property. The item’s Description property specifies the text associated with a specific item.

The EditValue property is related to the item’s Value property of the selected item. When you select a specific item from the dropdown window, the EditValue property is automatically set to the value of the item’s Value property. Conversely, by setting the EditValue property you select the corresponding item whose Value property’s value matches EditValue.