ListViewItem.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 mostrada para el elemento.
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 propiedad
Índice de base cero de la imagen en el ImageList que se muestra para el elemento. El valor predeterminado es -1.
- Atributos
Excepciones
value es menor que 1.
Comentarios
El valor de esta propiedad depende del valor de la ImageList propiedad . Dependiendo del valor actual de la View ListView propiedad del control asociado al elemento, el ImageList utilizado por el elemento podría ser uno especificado en la LargeImageList propiedad o la SmallImageList propiedad del ListView control. Si la View propiedad se establece LargeIconen , se utiliza el ImageList especificado en la LargeImageList propiedad ; de lo contrario, se usa el ImageList especificado en la SmallImageList propiedad . Las imágenes definidas en el ImageList especificado en la SmallImageList propiedad deben tener las mismas posiciones de índice que las imágenes del ImageList especificado en la LargeImageList propiedad . Si las posiciones de índice son las mismas para ambos ImageList controles, puede establecer un único valor de índice para la ImageIndex propiedad y se mostrará la imagen adecuada independientemente del valor de la View propiedad del ListView control.
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 la propiedad se ajusta a uno menor que el valor de la Count propiedad.
Por ejemplo, considere un control de botón cuya ImageList propiedad 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.