ListViewItem.ImageIndex Propriedade

Definição

Obtém ou define o índice da imagem que é exibido para o item.Gets or sets the index of the image that is displayed for the item.

public:
 property int ImageIndex { int get(); void set(int value); };
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))]
public int ImageIndex { get; set; }
member this.ImageIndex : int with get, set
Public Property ImageIndex As Integer

Valor da propriedade

O índice baseado em zero da imagem no ImageList que é exibido para o item.The zero-based index of the image in the ImageList that is displayed for the item. O padrão é -1.The default is -1.

Atributos

Exceções

O valor especificado é menor que -1.The value specified is less than -1.

Comentários

O valor dessa propriedade depende do valor da propriedade ImageList.The value of this property depends on the value of the ImageList property. Dependendo do valor atual da propriedade View do controle de ListView associado ao item, o ImageList usado pelo item poderia ser um especificado na propriedade LargeImageList ou a propriedade SmallImageList do controle ListView.Depending on the current value of the View property of the ListView control associated with the item, the ImageList used by the item could be one specified in the LargeImageList property or the SmallImageList property of the ListView control. Se a propriedade View for definida como LargeIcon, a ImageList especificada na propriedade LargeImageList será usada; caso contrário, o ImageList especificado na propriedade SmallImageList será usado.If the View property is set to LargeIcon, the ImageList specified in the LargeImageList property is used; otherwise, the ImageList specified in the SmallImageList property is used. As imagens definidas no ImageList especificado na SmallImageList devem ter as mesmas posições de índice que as imagens no ImageList especificado na propriedade LargeImageList.The images defined in the ImageList specified in the SmallImageList should have the same index positions as the images in the ImageList specified in the LargeImageList property. Se as posições de índice forem as mesmas para os dois controles de ImageList, você poderá definir um único valor de índice para a propriedade ImageIndex e a imagem apropriada será exibida, independentemente do valor da propriedade View do controle de ListView.If the index positions are the same for both ImageList controls, you can set a single index value for the ImageIndex property and the appropriate image will be displayed regardless of the value of the View property of the ListView control. As propriedades ImageKey e ImageIndex são mutuamente exclusivas, o que significa que, se uma for definida, a outra será ignorada.The ImageKey and ImageIndex properties are mutually exclusive, meaning if one is set, the other is ignored. Além disso, se você definir a propriedade ImageKey, a propriedade ImageIndex será definida automaticamente como-1.Furthermore, if you set the ImageKey property, the ImageIndex property is automatically set to -1. Como alternativa, se você definir a propriedade ImageIndex, a ImageKey será definida automaticamente como uma cadeia de caracteres vazia ("").Alternatively, if you set the ImageIndex property, the ImageKey is automatically set to an empty string ("").

Aplica-se a

Veja também