ListViewItem.ImageIndex Propriedade
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Obtém ou define o índice da imagem que é apresentada 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 de Propriedade
O índice em base zero da imagem no ImageList que é exibido para o item. O padrão é -1.
- Atributos
Exceções
value é inferior a -1.
Observações
O valor desta propriedade depende do valor da ImageList propriedade. Dependendo do valor atual da View propriedade do ListView controlo associada ao item, o ImageList utilizado pelo item pode ser um especificado na LargeImageList propriedade ou o SmallImageList bem do ListView controlo. Se a View propriedade for definida para LargeIcon, o ImageList especificado na LargeImageList propriedade é usado; caso contrário, o ImageList especificado na SmallImageList propriedade é 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 do índice forem as mesmas para ambos ImageList os controlos, pode definir um único valor de índice para a ImageIndex propriedade e a imagem apropriada será exibida independentemente do valor da View propriedade do ListView controlo.
ImageKey e ImageIndex são mutuamente exclusivas, ou seja, se um for definido, o outro é atribuído a um valor inválido e ignorado. Se definires a ImageKey propriedade, ela ImageIndex é automaticamente definida para -1. Alternativamente, se definir a ImageIndex propriedade, o ImageKey é automaticamente definido para uma cadeia vazia ("").
Se o valor da ImageList propriedade for alterado para null, a ImageIndex propriedade devolve o 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 valor atribuído à ImageList propriedade tiver ImageList.ImageCollection.Count um valor inferior ou igual ao valor atribuído à ImageIndex propriedade menos um (para considerar que a coleção é um índice baseado em zero), o ImageIndex valor da propriedade é ajustado para um valor inferior ao Count valor da propriedade.
Por exemplo, considere um controlo de botão que ImageList tem três imagens e cuja ImageIndex propriedade está definida para 2. Se um novo ImageList que tenha apenas duas imagens for atribuído ao botão, o ImageIndex valor muda para 1.