ListViewItem.ImageIndex Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Obtém ou define o índice da imagem exibida para o item.
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.NoneExcludedImageIndexConverter))]
public int ImageIndex { get; set; }[<System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.ImageIndexConverter))>]
member this.ImageIndex : int with get, set[<System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.NoneExcludedImageIndexConverter))>]
member this.ImageIndex : int with get, setPublic Property ImageIndex As IntegerValor da propriedade
O índice baseado em zero da imagem no ImageList que é exibido para o item. O padrão é -1.
- Atributos
Exceções
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 estiver definida como LargeIcon, a ImageList especificada na LargeImageList propriedade será usada; caso contrário, a ImageList propriedade especificada SmallImageList será usada. As imagens definidas na ImageList propriedade especificada SmallImageList devem ter as mesmas posições de índice que as imagens especificadas ImageList 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, ela ImageKey será definida 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 é mantido 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 cujas ImageList três imagens e cuja ImageIndex propriedade está definida como 2. Se uma nova ImageList que tem apenas duas imagens for atribuída ao botão, o ImageIndex valor será alterado para 1.
