ButtonBase.ImageIndex Właściwość

Definicja

Przestrzeń nazw:

System.Windows.Forms

Zestaw:

System.Windows.Forms.dll

Pobiera lub ustawia wartość indeksu listy obrazów obrazu wyświetlanego w kontrolce przycisku.

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

Wartość właściwości

Int32

Indeks oparty na zera, który reprezentuje pozycję obrazu w obiekcie ImageList. Wartość domyślna to -1.

Atrybuty

TypeConverterAttribute

Wyjątki

ArgumentOutOfRangeException

value wartość jest mniejsza niż -1.

Przykłady

W poniższym przykładzie kodu użyto klasy Button pochodnej i ustawiono ImageList właściwości i ImageIndex . Ten kod wymaga utworzenia elementu ImageList i przypisano do niego co najmniej jeden Image kod. Ten kod wymaga również obrazu mapy bitowej o nazwie MyBitMap.bmp przechowywanej C:\Graphics w katalogu.

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

Uwagi

Po ustawieniu ImageIndex właściwości lub ImageList właściwość jest ustawiona Image na wartość domyślną . null

ImageKey i ImageIndex wzajemnie wykluczają się, co oznacza, że jeśli jeden jest ustawiony, drugi jest ustawiony na nieprawidłową wartość i ignorowany. Jeśli ustawisz ImageKey właściwość , właściwość zostanie automatycznie ustawiona ImageIndex na -1. Alternatywnie, jeśli ustawisz ImageIndex właściwość , ImageKey właściwość zostanie automatycznie ustawiona na pusty ciąg ("").

Jeśli wartość właściwości zostanie zmieniona ImageList na null, ImageIndex właściwość zwróci jej wartość domyślną, -1. Jednak przypisana ImageIndex wartość jest zachowywana wewnętrznie i używana, gdy do właściwości jest przypisany ImageList inny ImageList obiekt. Jeśli nowa ImageList przypisana do ImageList właściwości ma wartość właściwości mniejszą lub równą ImageList.ImageCollection.Count wartości przypisanej ImageIndex do właściwości minus jeden (do konta kolekcji będącej indeksem opartym na zerze), ImageIndex wartość właściwości jest dostosowywana do jednej mniejszej niż Count wartość właściwości. Rozważmy na przykład kontrolkę ImageList przycisku z trzema obrazami i właściwość ImageIndex ustawioną na 2. Jeśli nowy ImageList , który ma tylko dwa obrazy, zostanie przypisany do przycisku, ImageIndex wartość zmieni się na 1.

Zobacz też

• ImageList