ButtonBase.ImageIndex Tulajdonság

Definíció

Névtér:

System.Windows.Forms

Szerelvény:

System.Windows.Forms.dll

Forrás:

ButtonBase.cs

Lekéri vagy beállítja a gombvezérlőn megjelenített kép képlista indexértékét.

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

Tulajdonság értéke

Int32

Nulla alapú index, amely a kép pozícióját jelöli egy ImageList. Az alapértelmezett érték -1.

Attribútumok

TypeConverterAttribute

Kivételek

ArgumentOutOfRangeException

value kisebb, mint -1.

Példák

Az alábbi példakód a származtatott osztályt használja, Button és beállítja a ImageList tulajdonságokat.ImageIndex Ehhez a kódhoz létre kell hozni egy ImageList példányt, és legalább egyet Image hozzá kell rendelni. Ehhez a kódhoz egy bitképet is el kell nevezni MyBitMap.bmp a C:\Graphics könyvtárban.

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

Megjegyzések

Ha a tulajdonság vagy ImageIndex tulajdonságok ImageList be vannak állítva, a Image tulajdonság az alapértelmezett értékre van állítva. null

ImageKey és ImageIndex kölcsönösen kizárják egymást, ami azt jelenti, hogy ha az egyik be van állítva, a másik érvénytelen értékre van állítva, és figyelmen kívül hagyja. Ha beállítja a ImageKey tulajdonságot, a ImageIndex tulajdonság automatikusan -1 értékre van állítva. Másik lehetőségként, ha beállítja a ImageIndex tulajdonságot, a ImageKey rendszer automatikusan üres sztringre ("") állítja be a tulajdonságot.

Ha a ImageList tulajdonság értéke megváltozik null, a tulajdonság az ImageIndex alapértelmezett értékét adja vissza ( -1). A hozzárendelt ImageIndex érték azonban belsőleg megmarad, és akkor lesz felhasználva, ha egy másik ImageList objektum van hozzárendelve a ImageList tulajdonsághoz. Ha a tulajdonsághoz ImageList rendelt új ImageList tulajdonság értéke kisebb vagy egyenlő a tulajdonsághoz ImageList.ImageCollection.Count rendelt értéknél mínusz egynél (figyelembe véve, hogy a gyűjtemény nulla alapú index), a ImageIndex tulajdonság értéke a tulajdonság értékénél ImageIndex egy kisebbre van módosítva.Count Vegyük például azt a gombvezérlőt, amelynek ImageList három képe van, és amelynek ImageIndex tulajdonsága 2. Ha a ImageList gombhoz csak két kép van rendelve, az ImageIndex érték 1 lesz.

Lásd még

• ImageList