ButtonBase.ImageIndex プロパティ

定義

ボタン コントロールに表示されているイメージのイメージ リスト内でのインデックス値を取得または設定します。Gets or sets the image list index value of the image displayed on the button control.

public:
 property int ImageIndex { int get(); void set(int value); };
[System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.ImageIndexConverter))]
public int ImageIndex { get; set; }
member this.ImageIndex : int with get, set
Public Property ImageIndex As Integer

プロパティ値

ImageList 内でのイメージの位置を表す 0 から始まるインデックス。A zero-based index, which represents the image position in an ImageList. 既定値は -1 です。The default is -1.

属性

例外

代入された値が ImageIndex の下限値より小さいです。The assigned value is less than the lower bounds of the ImageIndex.

次のコード例では、派生クラスを使用して Button し、ImageList プロパティと ImageIndex プロパティを設定します。The following code example uses the derived class, Button and sets the ImageList and ImageIndex properties. このコードでは、ImageList が作成され、少なくとも1つの Image が割り当てられている必要があります。This code requires that an ImageList has been created and a minimum of one Image has been assigned to it. また、このコードでは、MyBitMap.bmp という名前のビットマップイメージが C:\Graphics ディレクトリに格納されている必要があります。This code also requires that you have a bitmap image named MyBitMap.bmp stored in the C:\Graphics directory.

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に設定されます。When the ImageIndex or ImageList properties are set, the Image property is set to its default value, null.

注意

ImageList プロパティの値が nullに変更された場合、ImageIndex プロパティは既定値の-1 を返します。If the ImageList property value is changed to null, the ImageIndex property returns its default value, -1. ただし、割り当てられた ImageIndex 値は内部で保持され、別の ImageList オブジェクトが ImageList プロパティに割り当てられるときに使用されます。However, the assigned ImageIndex value is retained internally and used when another ImageList object is assigned to the ImageList property. ImageList プロパティに割り当てられた新しい ImageList に、ImageIndex プロパティに割り当てられた値以下の ImageList.ImageCollection.Count プロパティ値がある場合 (コレクションが0から始まるインデックスである場合)、ImageIndex プロパティ値は、Count プロパティ値より1小さい値に調整されます。If the new ImageList assigned to the ImageList property has an ImageList.ImageCollection.Count property value that is less than or equal to the value assigned to the ImageIndex property minus one (to account for the collection being a zero-based index), the ImageIndex property value is adjusted to one less than the Count property value. たとえば、ImageList に3つのイメージがあり、ImageIndex プロパティが2に設定されているボタンコントロールがあるとします。For example, consider a button control whose ImageList has three images and whose ImageIndex property is set to 2. 2つのイメージのみを持つ新しい ImageList がボタンに割り当てられている場合、ImageIndex の値は1に変更されます。If a new ImageList that has only two images is assigned to the button, the ImageIndex value changes to 1.

適用対象

こちらもご覧ください