Compartir a través de


ListViewItem.ImageIndex Propiedad

Definición

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, set
Public Property ImageIndex As Integer

Valor de propiedad

Int32

Í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.

Se aplica a

Consulte también