ListViewItem.StateImageIndex Propriedade

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

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

public:
 property int StateImageIndex { int get(); void set(int value); };

[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.NoneExcludedImageIndexConverter))>]
[<System.Windows.Forms.RelatedImageList("ListView.StateImageList")>]
member this.StateImageIndex : int with get, set

Public Property StateImageIndex As Integer

Valor da propriedade

Int32

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

Atributos

TypeConverterAttribute RelatedImageListAttribute

Exceções

ArgumentOutOfRangeException

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 no ImageList atribuído à StateImageList propriedade do 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 marcada ou desmarcada quando a CheckBoxes propriedade do controle estiver definida truecomo .

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.

Confira também

• StateImageList