ButtonBase.ImageIndex Eigenschaft

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Quelle:

ButtonBase.cs

Dient zum Abrufen oder Festlegen des Indexwerts der Bildliste des Bilds, das im Schaltflächensteuerelement angezeigt wird.

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. Der Standardwert ist -1.

Attribute

TypeConverterAttribute

Ausnahmen

ArgumentOutOfRangeException

value ist kleiner als -1.

Beispiele

Im folgenden Codebeispiel wird die abgeleitete Klasse verwendet und Button die und ImageIndex die ImageList Eigenschaften festgelegt. Dieser Code erfordert, dass eine ImageList erstellt wurde und ihm mindestens eins Image zugewiesen wurde. Dieser Code erfordert außerdem, dass Sie ein Bitmapbild mit dem C:\Graphics Namen MyBitMap.bmp "Im Verzeichnis" gespeichert haben.

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 ImageList festgelegt werden, wird die Image Eigenschaft auf den Standardwert festgelegt. null

ImageKey und ImageIndex schließen sich gegenseitig aus, d. h. wenn ein Wert 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. Wenn Sie die ImageIndex Eigenschaft festlegen, wird die ImageKey Eigenschaft auch automatisch auf eine leere Zeichenfolge ("") festgelegt.

Wenn der ImageList Eigenschaftswert geändert nullwird, 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 Wert ist, der der Eigenschaft minus 1 zugewiesen ImageIndex ist (um die Auflistung als nullbasierten Index zu berücksichtigen), wird der ImageIndex Eigenschaftswert auf einen Wert angepasst, der kleiner als der Count Eigenschaftswert ist. Betrachten Sie z. B. ein Schaltflächensteuerelement, dessen ImageList Eigenschaft drei Bilder aufweist und deren ImageIndex Eigenschaft auf 2 festgelegt ist. Wenn der Schaltfläche nur zwei ImageList Bilder zugewiesen sind, ändert sich der ImageIndex Wert in 1.

Weitere Informationen

• ImageList