ButtonBase.ImageIndex Eigenschaft

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Ruft den Indexwert des Bilds in der Bildliste ab, das auf dem Schaltflächen-Steuerelement angezeigt wird, oder legt diesen fest.

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

Eigenschaftswert

Int32

Ein nullbasierter Index, der die Bildposition in einer ImageList angibt. Der Standard ist -1.

Attribute

TypeConverterAttribute

Ausnahmen

ArgumentOutOfRangeException

value ist kleiner als -1.

Beispiele

Im folgenden Codebeispiel wird die abgeleitete Klasse verwendet und Button die ImageList Eigenschaften und ImageIndex festgelegt. Für diesen Code ist es erforderlich, dass ein ImageList erstellt wurde und ihm mindestens eine Image zugewiesen wurde. Für diesen Code muss auch ein Bitmapbild namens MyBitMap.bmp im C:\Graphics Verzeichnis gespeichert sein.

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

Hinweise

Wenn die ImageIndex Eigenschaften oder ImageList festgelegt sind, wird die Image -Eigenschaft auf ihren Standardwert festgelegt, null.

ImageKey und ImageIndex schließen sich gegenseitig aus, d. h., wenn eine festgelegt ist, wird der andere auf einen ungültigen Wert festgelegt und ignoriert. Wenn Sie die ImageKey -Eigenschaft festlegen, wird die ImageIndex -Eigenschaft automatisch auf -1 festgelegt. Alternativ wird beim Festlegen der ImageIndex -Eigenschaft ImageKey automatisch auf eine leere Zeichenfolge ("") festgelegt.

Wenn der ImageList Eigenschaftswert in nullgeändert wird, gibt die ImageIndex Eigenschaft den Standardwert -1 zurück. Der zugewiesene ImageIndex Wert wird jedoch intern beibehalten und verwendet, wenn der ImageList -Eigenschaft ein anderes ImageList Objekt zugewiesen wird. Wenn die neue ImageList der ImageList Eigenschaft zugewiesene Eigenschaft einen ImageList.ImageCollection.Count Eigenschaftswert aufweist, der kleiner oder gleich dem der ImageIndex Eigenschaft zugewiesenen Wert minus 1 ist (um zu berücksichtigen, dass die Auflistung ein nullbasierter Index ist), wird der ImageIndex Eigenschaftswert auf eins kleiner als der Count Eigenschaftswert angepasst. Betrachten Sie beispielsweise ein Schaltflächensteuerelement, dessen ImageList drei Bilder aufweist und dessen ImageIndex Eigenschaft auf 2 festgelegt ist. Wenn der Schaltfläche ein neues ImageList mit nur zwei Bildern zugewiesen wird, ändert sich der ImageIndex Wert in 1.

Weitere Informationen

• ImageList