Skip to main content

TcxImageComboBoxItem.ImageIndex Property

Specifies the index in image lists associated with the parent image combo box editor.

Declaration

property ImageIndex: TcxImageIndex read; write; default -1;

Property Value

Type Description
TcxImageIndex

The index of the displayed image in a source image list.

If the property value is -1, the image combo box item displays no image.

Remarks

Use Description and ImageIndex properties to display a description and an image in the image combo box item.

VCL Editors Library: An Image Combo Box Item

The ImageIndex property specifies the index in image lists assigned to the parent image combo box editor’s Properties.Images and Properties.LargeImages properties.

Code Example

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

Default Value

The ImageIndex property’s default value is -1.

The default ImageIndex property value indicates that the image combo box item displays no image.

See Also