ButtonBase.ImageIndex Egenskap

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

Egenskapsvärde

Ett nollbaserat index som representerar bildpositionen i en ImageList. Standardvärdet är -1.

Attribut

TypeConverterAttribute

Undantag

Exempel

I följande kodexempel används den härledda klassen Button och egenskaperna och ImageList angesImageIndex. Den här koden kräver att en ImageList har skapats och minst en Image har tilldelats till den. Den här koden kräver också att du har en bitmappsbild med namnet MyBitMap.bmp lagrad i C:\Graphics katalogen.

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

Kommentarer

ImageIndex När egenskaperna eller ImageList anges Image anges egenskapen till dess standardvärde, null.

ImageKey och ImageIndex är ömsesidigt uteslutande, vilket innebär att om det ena anges, anges det andra till ett ogiltigt värde och ignoreras. Om du anger egenskapen ImageKey anges egenskapen ImageIndex automatiskt till -1. Om du anger ImageIndex egenskapen ImageKey anges den också automatiskt till en tom sträng ("").

Om egenskapsvärdet ImageList ändras till nullImageIndex returnerar egenskapen standardvärdet -1. Det tilldelade ImageIndex värdet behålls dock internt och används när ett annat ImageList objekt tilldelas egenskapen ImageList . Om den nya ImageList tilldelade ImageList egenskapen har ett ImageList.ImageCollection.Count egenskapsvärde som är mindre än eller lika med det värde som tilldelats ImageIndex egenskapen minus ett (för att ta hänsyn till att samlingen är ett nollbaserat index) ImageIndex justeras egenskapsvärdet till ett mindre än egenskapsvärdet Count . Överväg till exempel en knappkontroll vars ImageList tre bilder och vars ImageIndex egenskap är inställd på 2. Om en ny ImageList som bara har två bilder tilldelas knappen ImageIndex ändras värdet till 1.

Se även

• ImageList