ColumnHeader.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 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 da propriedade
O índice da imagem exibida no ColumnHeader.
- Atributos
Exceções
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.
