ListViewItem.ImageIndex Propriedade

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Obtém ou define o índice da imagem que é exibido para o item.

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

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

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

Public Property ImageIndex As Integer

Valor da propriedade

Int32

O índice baseado em zero da imagem no ImageList que é exibido para o item. O padrão é -1.

Atributos

TypeConverterAttribute

Exceções

ArgumentOutOfRangeException

value é menor que -1.

Comentários

O valor dessa propriedade depende do valor da ImageList propriedade . Dependendo do valor atual da View propriedade do ListView controle associado ao item, o ImageList usado pelo item pode ser um especificado na LargeImageList propriedade ou na SmallImageList propriedade do ListView controle. Se a View propriedade for definida como LargeIcon, o ImageList especificado na LargeImageList propriedade será usado; caso contrário, o ImageList especificado na SmallImageList propriedade será usado. As imagens definidas no ImageList especificado na SmallImageList propriedade devem ter as mesmas posições de índice que as imagens no ImageList especificado na LargeImageList propriedade . Se as posições de índice forem as mesmas para ambos os ImageList controles, você poderá definir um único valor de índice para a ImageIndex propriedade e a imagem apropriada será exibida independentemente do valor da View propriedade do ListView controle.

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.

Confira também

• View
• SmallImageList
• LargeImageList