ColumnHeader.ImageIndex Propiedad

Definición

Espacio de nombres:

System.Windows.Forms

Ensamblado:

System.Windows.Forms.dll

Obtiene o establece el índice de la imagen que se muestra en el objeto 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, set

Public Property ImageIndex As Integer

Valor de propiedad

Int32

Índice de la imagen mostrada en el objeto ColumnHeader.

Atributos

TypeConverterAttribute

Excepciones

ArgumentOutOfRangeException

value es menor que 1.

Comentarios

La ImageIndex propiedad hace referencia al índice de una imagen especificada por la SmallImageList propiedad de ListView que contiene .ColumnHeader La ImageIndex propiedad devuelve -1 si no hay ningún SmallImageList conjunto en el objeto contenedor ListView. La imagen que se muestra en una columna se usa normalmente para indicar el estado de los elementos de la columna.

ImageKey y ImageIndex son mutuamente excluyentes, lo que significa que, si se establece uno, el otro se establece en un valor no válido y se omite. Si establece la ImageKey propiedad , la ImageIndex propiedad se establece automáticamente en -1. Como alternativa, si establece la ImageIndex propiedad , se ImageKey establece automáticamente en una cadena vacía ("").

Si el valor de la ImageList propiedad se cambia a null, la ImageIndex propiedad devuelve su valor predeterminado, -1. Sin embargo, el valor asignado ImageIndex se conserva internamente y se usa cuando se asigna otro ImageList objeto a la ImageList propiedad . Si el nuevo ImageList asignado a la ImageList propiedad tiene un ImageList.ImageCollection.Count valor de propiedad menor o igual que el valor asignado a la ImageIndex propiedad menos uno (para tener en cuenta que la colección es un índice de base cero), el ImageIndex valor de propiedad se ajusta a uno menor que el valor de propiedad Count . Por ejemplo, considere un control de botón cuya propiedad ImageList tiene tres imágenes y cuya ImageIndex propiedad está establecida en 2. Si un nuevo ImageList que solo tiene dos imágenes se asigna al botón, el ImageIndex valor cambia a 1.