ButtonBase.ImageList Egenskap

Definition

Hämtar eller anger ImageList som innehåller som Image visas på en knappkontroll.

public:
 property System::Windows::Forms::ImageList ^ ImageList { System::Windows::Forms::ImageList ^ get(); void set(System::Windows::Forms::ImageList ^ value); };
public System.Windows.Forms.ImageList ImageList { get; set; }
public System.Windows.Forms.ImageList? ImageList { get; set; }
member this.ImageList : System.Windows.Forms.ImageList with get, set
Public Property ImageList As ImageList

Egenskapsvärde

En ImageList. Standardvärdet är null.

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

ImageList När egenskapen eller ImageIndex anges Image anges nullegenskapen , vilket är dess standardvärde.

Note

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 en annan ImageList 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 (eftersom 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.

Gäller för

Se även