ColumnHeader.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 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, setPublic Property ImageIndex As IntegerValor de Propriedade
O índice da imagem apresentada no ColumnHeaderarquivo .
- Atributos
Exceções
value é inferior a -1.
Observações
A ImageIndex propriedade refere-se ao índice de uma imagem especificada pela SmallImageList propriedade de ListView que contém o ColumnHeader. A ImageIndex propriedade devolve -1 se não SmallImageList existir um conjunto no que contém ListView. A imagem apresentada numa coluna é normalmente usada para indicar o estado dos itens na coluna.
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.