ColumnHeader.ImageIndex Propiedad
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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, setPublic Property ImageIndex As IntegerValor de propiedad
Índice de la imagen mostrada en el objeto ColumnHeader.
- Atributos
Excepciones
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.
