ListViewItem.ImageKey Propriedade

Definição

Obtém ou define a chave para a imagem que é exibida para o item.Gets or sets the key for the image that is displayed for the item.

public:
 property System::String ^ ImageKey { System::String ^ get(); void set(System::String ^ value); };
public string ImageKey { get; set; }
[System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.ImageKeyConverter))]
public string ImageKey { get; set; }
member this.ImageKey : string with get, set
Public Property ImageKey As String

Valor da propriedade

A chave para a imagem que é exibida para o ListViewItem.The key for the image that is displayed for the ListViewItem.

Atributos

Comentários

A propriedade ImageKey retorna uma cadeia de caracteres vazia ("") quando o ImageKey não está definido para o ListViewItem.The ImageKey property returns an empty string ("") when the ImageKey is not set for the ListViewItem. 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. Se você definir a propriedade ImageKey, a propriedade ImageIndex será definida automaticamente como-1.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 ("").

Observação

Se você estiver usando várias listas de imagens, para exibição de ícones pequenos e grandes, com um controle de ListView, você deve posicionar versões pequenas e grandes da imagem no mesmo local de índice em suas respectivas listas de imagens.If you are using multiple image lists, for small and large icon view, with a ListView control, you should place small and large versions of the image at the same index location in their respective image lists. Ao alternar entre exibições, o local do índice da imagem em uma lista é usado para localizar a imagem na outra lista, independentemente do valor de chave especificado.When switching between views, the index location of the image in one list is used to locate the image in the other list, regardless of the key value specified.

Aplica-se a