ButtonBase.ImageIndex Vlastnost

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Získá nebo nastaví hodnotu indexu seznamu obrázků obrázku zobrazeného v ovládacím prvku tlačítko.

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

[System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.ImageIndexConverter))]
public int ImageIndex { get; set; }

[<System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.ImageIndexConverter))>]
member this.ImageIndex : int with get, set

Public Property ImageIndex As Integer

Hodnota vlastnosti

Int32

Index založený na nule, který představuje pozici obrázku v objektu ImageList. Výchozí hodnota je -1.

Atributy

TypeConverterAttribute

Výjimky

ArgumentOutOfRangeException

value je menší než -1.

Příklady

Následující příklad kódu používá odvozenou třídu Button a nastaví ImageList a ImageIndex vlastnosti. Tento kód vyžaduje, aby ImageList byl vytvořen a k němu byla přiřazena minimálně jedna Image . Tento kód také vyžaduje, abyste měli rastrový obrázek s názvem MyBitMap.bmp uložený v C:\Graphics adresáři.

private:
   void AddMyImage()
   {
      // Assign an image to the imageList.
      imageList1->Images->Add( Image::FromFile( "C:\\Graphics\\MyBitmap.bmp" ) );
      // Assign the imageList to the button control.
      button1->ImageList = imageList1;
      // Select the image from the ImageList (using the ImageIndex property).
      button1->ImageIndex = 0;
   }

private void AddMyImage()
 {
    // Assign an image to the ImageList.
    ImageList1.Images.Add(Image.FromFile("C:\\Graphics\\MyBitmap.bmp"));
    // Assign the ImageList to the button control.   
    button1.ImageList = ImageList1;
    // Select the image from the ImageList (using the ImageIndex property).    
    button1.ImageIndex = 0;
 }

Private Sub AddMyImage()
    ' Assign an image to the ImageList.
    ImageList1.Images.Add(Image.FromFile("C:\Graphics\MyBitmap.bmp"))
    ' Assign the ImageList to the button control.   
    button1.ImageList = ImageList1
    ' Select the image from the ImageList (using the ImageIndex property).    
    button1.ImageIndex = 0
End Sub

Poznámky

Pokud jsou nastaveny ImageIndex vlastnosti ImageList , Image vlastnost je nastavena na výchozí hodnotu, null.

ImageKey a ImageIndex vzájemně se vylučují, což znamená, že pokud je nastavena jedna, druhá je nastavena na neplatnou hodnotu a ignorována. Pokud vlastnost nastavíte ImageKey , ImageIndex vlastnost se automaticky nastaví na -1. Pokud vlastnost ImageIndex nastavíte, ImageKey nastaví se automaticky na prázdný řetězec ("").

Pokud se ImageList hodnota vlastnosti změní na null, vrátí ImageIndex vlastnost výchozí hodnotu -1. Přiřazená ImageIndex hodnota se však uchovává interně a používá se při přiřazení jiného ImageList objektu ImageList k vlastnosti. Pokud má nová ImageList přiřazená vlastnost ImageList hodnotu vlastnosti ImageList.ImageCollection.Count , která je menší nebo rovna hodnotě přiřazené vlastnosti ImageIndex minus jedna (pro účet kolekce je index založený na nule), ImageIndex je hodnota vlastnosti upravena na jednu menší než Count hodnota vlastnosti. Představte si například ovládací prvek tlačítka, jehož ImageList má tři obrázky a jehož ImageIndex vlastnost je nastavena na hodnotu 2. Pokud je tlačítku přiřazena nová ImageList , která obsahuje pouze dva obrázky, ImageIndex hodnota se změní na 1.

Viz také

• ImageList