ColumnHeader.ImageIndex Propriedade

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Obtém ou define o índice da imagem exibida no ColumnHeader.

public:
 property int ImageIndex { int get(); void set(int value); };

[System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.ImageIndexConverter))]
public int ImageIndex { get; set; }

[<System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.ImageIndexConverter))>]
member this.ImageIndex : int with get, set

Public Property ImageIndex As Integer

Valor da propriedade

Int32

O índice da imagem exibida no ColumnHeader.

Atributos

TypeConverterAttribute

Exceções

ArgumentOutOfRangeException

value é menor que -1.

Comentários

A ImageIndex propriedade refere-se ao índice de uma imagem especificada pela SmallImageList propriedade do ListView que contém o ColumnHeader. A ImageIndex propriedade retornará -1 se não houver nenhum SmallImageList conjunto no que contém ListView. A imagem exibida em uma coluna normalmente é usada para indicar o estado dos itens na coluna.

ImageKey e ImageIndex são mutuamente exclusivos, ou seja, se um for definido, o outro será definido como um valor inválido e ignorado. Se você definir a ImageKey propriedade, a ImageIndex propriedade será definida automaticamente como -1. Como alternativa, se você definir a ImageIndex propriedade, o ImageKey será definido automaticamente como uma cadeia de caracteres vazia ("").

Se o valor da ImageList propriedade for alterado para null, a ImageIndex propriedade retornará seu valor padrão, -1. No entanto, o valor atribuído ImageIndex é retido internamente e usado quando outro ImageList objeto é atribuído à ImageList propriedade . Se o novo ImageList atribuído à ImageList propriedade tiver um ImageList.ImageCollection.Count valor de propriedade menor ou igual ao valor atribuído à ImageIndex propriedade menos um (para considerar a coleção sendo um índice baseado em zero), o valor da ImageIndex propriedade será ajustado para um menor que o valor da Count propriedade. Por exemplo, considere um controle de botão cujo ImageList tem três imagens e cuja ImageIndex propriedade é definida como 2. Se um novo ImageList que tem apenas duas imagens for atribuído ao botão, o ImageIndex valor será alterado para 1.