ListViewItem.StateImageIndex Propriedade

Definição

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.Gets or sets the index of the state image (an image such as a selected or cleared check box that indicates the state of the item) that is displayed for the item.

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

Valor da propriedade

O índice de base zero da imagem de estado no ImageList que é exibido para o item.The zero-based index of the state image in the ImageList that is displayed for the item.

Atributos

Exceções

O valor especificado para essa propriedade é menor que -1.The value specified for this property is less than -1.

-ou--or-

O valor especificado para essa propriedade é maior que 14.The value specified for this property is greater than 14.

Comentários

Essa propriedade permite que você especifique o índice no ImageList atribuído à propriedade StateImageList do controle de ListView associado, em que as imagens de estado a serem exibidas à esquerda do item são armazenadas.This property allows you to specify the index into the ImageList assigned to the StateImageList property of the associated ListView control, where the state images to display to the left of the item are stored. Normalmente, a imagem de estado é uma caixa de seleção selecionada ou desmarcada ou uma imagem que se destina a representar os Estados selecionados ou desmarcados para o item.Typically, the state image is a selected or cleared check box or an image that is intended to represent selected or cleared states for the item. Se nenhum valor for especificado para a propriedade StateImageList, o controle ListView exibirá uma caixa de seleção padrão marcada ou desmarcada quando a propriedade CheckBoxes do controle for definida como true.If no value is specified for the StateImageList property, the ListView control displays a default selected or cleared check box when the CheckBoxes property of the control is set to true.

Observação

Embora o ImageList especificado na propriedade StateImageList possa conter qualquer número de imagens, e a propriedade StateImageIndex pode 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.Although the ImageList specified in the StateImageList property can contain any number of images, and the StateImageIndex property can be set to any value equal to or lower than 14, only the images at index positions 0 and 1 are displayed as state images.

Aplica-se a

Veja também