ButtonBase.ImageIndex Eigenschap

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

Waarde van eigenschap

Een op nul gebaseerde index, die de afbeeldingspositie in een ImageList. De standaardwaarde is -1.

Kenmerken

TypeConverterAttribute

Uitzonderingen

Voorbeelden

In het volgende codevoorbeeld wordt de afgeleide klasse Button gebruikt en worden de ImageList en ImageIndex eigenschappen ingesteld. Deze code vereist dat er een ImageList is gemaakt en er minimaal één Image is toegewezen. Deze code vereist ook dat u een bitmapafbeelding hebt die is opgeslagen MyBitMap.bmp in de C:\Graphics map.

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

Opmerkingen

Wanneer de ImageIndex of ImageList eigenschappen zijn ingesteld, wordt de eigenschap ingesteld op de Image standaardwaarde. null

ImageKey en ImageIndex wederzijds uitsluiten, wat betekent dat als de ene is ingesteld, de andere wordt ingesteld op een ongeldige waarde en genegeerd. Als u de ImageKey eigenschap instelt, wordt de ImageIndex eigenschap automatisch ingesteld op -1. Als u de eigenschap instelt, wordt de ImageIndexImageKey eigenschap ook automatisch ingesteld op een lege tekenreeks ("").

Als de ImageList eigenschapswaarde wordt gewijzigd nullin , retourneert de eigenschap de ImageIndex standaardwaarde -1. De toegewezen ImageIndex waarde wordt echter intern bewaard en gebruikt wanneer een ander ImageList object aan de ImageList eigenschap wordt toegewezen. Als de nieuwe ImageList die aan de ImageList eigenschap is toegewezen een ImageList.ImageCollection.Count eigenschapswaarde heeft die kleiner is dan of gelijk is aan de waarde die is toegewezen aan de ImageIndex eigenschap min één (om rekening te houden met de verzameling als een op nul gebaseerde index), wordt de ImageIndex eigenschapswaarde aangepast aan een waarde die kleiner is dan de Count eigenschapswaarde. Denk bijvoorbeeld aan een knopbesturingselement met ImageList drie afbeeldingen en waarvan de ImageIndex eigenschap is ingesteld op 2. Als er ImageList slechts twee afbeeldingen aan de knop zijn toegewezen, wordt de ImageIndex waarde gewijzigd in 1.

Zie ook

• ImageList