Compartilhar via


ListViewItem.StateImageIndex Propriedade

Definição

Obtém ou define o índice da imagem de estado (uma imagem como uma caixa de seleção selecionada ou desmarcada que indica o estado do item) que é exibida para o item.

public:
 property int StateImageIndex { int get(); void set(int value); };
[System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.ImageIndexConverter))]
public int StateImageIndex { get; set; }
[System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.NoneExcludedImageIndexConverter))]
[System.Windows.Forms.RelatedImageList("ListView.StateImageList")]
public int StateImageIndex { get; set; }
[<System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.ImageIndexConverter))>]
member this.StateImageIndex : int with get, set
[<System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.NoneExcludedImageIndexConverter))>]
[<System.Windows.Forms.RelatedImageList("ListView.StateImageList")>]
member this.StateImageIndex : int with get, set
Public Property StateImageIndex As Integer

Valor da propriedade

O índice baseado em zero da imagem de estado no ImageList que é exibido para o item.

Atributos

Exceções

O valor especificado para essa propriedade é menor que -1.

- ou -

O valor especificado para essa propriedade é maior que 14.

Comentários

Essa propriedade permite que você especifique o índice na ImageList propriedade atribuída ao StateImageList controle associado ListView , em que as imagens de estado a serem exibidas à esquerda do item são armazenadas. Normalmente, a imagem de estado é uma caixa de seleção selecionada ou desmarcada ou uma imagem que se destina a representar estados selecionados ou desmarcados para o item. Se nenhum valor for especificado para a StateImageList propriedade, o ListView controle exibirá uma caixa de seleção padrão selecionada ou desmarcada quando a CheckBoxes propriedade do controle for definida como true.

Observação

Embora o ImageList especificado na StateImageList propriedade possa conter qualquer número de imagens e a StateImageIndex propriedade possa ser definida como qualquer valor igual ou inferior a 14, somente as imagens nas posições de índice 0 e 1 são exibidas como imagens de estado.

Aplica-se a

Confira também