Skip to main content

DevExpress v24.2 Update — Your Feedback Matters

Our What's New in v24.2 webpage includes product-specific surveys. Your response to our survey questions will help us measure product satisfaction for features released in this major update and help us refine our plans for our next major release.

Take the survey Not interested

TcxImageComboBoxProperties Class

Stores image combo box editor settings.

#Declaration

Delphi
TcxImageComboBoxProperties = class(
    TcxCustomImageComboBoxProperties
)

#Remarks

The TcxImageComboBoxProperties class implements a collection of image combo box items and related settings that allow you to configure these items.

#Main API Members

The list below outlines key members of the TcxImageComboBoxProperties class. These members allow you to manage image combo box items, specify image sources, and configure general editor settings.

DefaultDescription | DefaultImageIndex
Specify the editor’s content when no item is selected.
FindItemByValue
Returns a combo box editor by its value.
ImageAlign
Aligns the position of images at the drop-down button or at the opposite editor border.
Images | LargeImages
Specify image sources for image combo box items.
Items
Provides access to the collection of image combo box items. You can call the Items.Add function to create new items as demonstrated in the code example below.
MultiLineText
Specifies if the image combo box editor wraps item descriptions in a drop-down window.
ShowDescriptions
Allows you to hide the description of an image combo box item in the edit box.

#Code Example: Create and Configure Image Combo Box Items

The following code example creates and configures four image combo box items:

var
  AItem: TcxImageComboBoxItem;
  AProperties: TcxImageComboBoxProperties;
begin
  AProperties := cxImageComboBox1.Properties;
  AProperties.BeginUpdate;
  try
    AItem := AProperties.Items.Add;
    AItem.ImageIndex := 0;
    AItem.Description := 'Dr';
    AItem.Value := 0;
    AItem := AProperties.Items.Add;
    AItem.ImageIndex := 1;
    AItem.Description := 'Mr';
    AItem.Value := 1;
    AItem := AProperties.Items.Add;
    AItem.ImageIndex := 2;
    AItem.Description := 'Ms';
    AItem.Value := 2;
    AItem := AProperties.Items.Add;
    AItem.ImageIndex := 3;
    AItem.Description := 'Mrs';
    AItem.Value := 3;
  finally
    AProperties.EndUpdate;
  end;
  cxImageComboBox1.EditValue := 0;
end;

VCL Editors Library: A Populated Image Combo Box Editor

#Direct TcxImageComboBoxProperties Class References

The following public API members reference a TcxImageComboBoxProperties object:

TcxImageComboBox.ActiveProperties
Provides access to active image combo box settings.
TcxImageComboBox.Properties
Provides access to image combo box settings.
TcxDBImageComboBox.ActiveProperties
Provides access to active image combo box settings.
TcxDBImageComboBox.Properties
Provides access to image combo box settings.
See Also