ButtonBase.ImageIndex 屬性

定義

命名空間:

System.Windows.Forms

組件:

System.Windows.Forms.dll

取得或設定按鈕控制項所顯示影像的影像清單索引值。

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

屬性值

Int32

以零起始的索引，表示 ImageList 中的影像位置。 預設值為 -1。

屬性

TypeConverterAttribute

例外狀況

ArgumentOutOfRangeException

value 小於 -1。

範例

下列程式碼範例會使用衍生類別， Button 並設定 ImageList 和 ImageIndex 屬性。 此程式碼需要已建立 ， ImageList 且至少已指派一個 Image 。 此程式碼也需要您有名為 MyBitMap.bmp 的點陣圖影像儲存在 C:\Graphics 目錄中。

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

備註

ImageIndex設定 或 ImageList 屬性時， Image 屬性會設定為其預設值 。 null

ImageKey 和 ImageIndex 互斥，這表示如果已設定，另一個設定為不正確值並忽略。 如果您設定 ImageKey 屬性， ImageIndex 則屬性會自動設定為 -1。 或者，如果您設定 ImageIndex 屬性，會自動 ImageKey 將 設定為空字串 (「」「) 。

ImageList如果屬性值變更為 null ，則 ImageIndex 屬性會傳回其預設值 -1。 不過，指派 ImageIndex 的值會在內部保留，並在將另一個 ImageList 物件指派給 ImageList 屬性時使用。 如果指派給 ImageList 屬性的新 ImageList 具有 ImageList.ImageCollection.Count 小於或等於指派給 ImageIndex 屬性的值減一 (，以將集合視為以零起始的索引) ImageIndex ，屬性值會調整為小於 Count 屬性值的一個。 例如，假設按鈕控制項有 ImageList 三個影像，且其 ImageIndex 屬性設定為 2。 如果只有兩個影像的新 ImageList 指派給按鈕，此值 ImageIndex 會變更為 1。

另請參閱

• ImageList