ListViewItem.StateImageIndex Vlastnost

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Získá nebo nastaví index obrázku stavu (obrázek, například zaškrtnuté nebo zrušené zaškrtávací políčko označující stav položky), který je zobrazen pro položku.

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

Hodnota vlastnosti

Int32

Index stavového obrázku založeného na nule v obrázku ImageList , který se zobrazí pro položku.

Atributy

TypeConverterAttribute RelatedImageListAttribute

Výjimky

ArgumentOutOfRangeException

Hodnota zadaná pro tuto vlastnost je menší než -1.

-nebo-

Hodnota zadaná pro tuto vlastnost je větší než 14.

Poznámky

Tato vlastnost umožňuje zadat index do přiřazené ImageListStateImageList vlastnosti přidruženého ListView ovládacího prvku, kde jsou uloženy stavové obrázky, které se mají zobrazit nalevo od položky. Stavový obrázek je obvykle zaškrtnuté nebo nezaškrtnuté políčko nebo obrázek, který je určen k reprezentaci vybraných nebo zrušených stavů pro danou položku. Pokud není pro StateImageList vlastnost zadána žádná hodnota, ListView ovládací prvek zobrazí výchozí políčko zaškrtnuté nebo nezaškrtnuté, pokud CheckBoxes je vlastnost ovládacího prvku nastavena na truehodnotu .

Poznámka

ImageList Přestože zadaná vlastnost StateImageList může obsahovat libovolný počet obrázků a StateImageIndex vlastnost může být nastavena na libovolnou hodnotu rovnající se nebo nižší než 14, jako stavové obrázky se zobrazí pouze obrázky na indexových pozicích 0 a 1.

Viz také

• StateImageList