ButtonBase.ImageIndex ButtonBase.ImageIndex ButtonBase.ImageIndex ButtonBase.ImageIndex Property

定義

ボタン コントロールに表示されているイメージのイメージ リスト内でのインデックス値を取得または設定します。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を使用しImageListImageIndex 、プロパティとプロパティを設定します。The following code example uses the derived class, Button and sets the ImageList and ImageIndex properties. このコードでは、 ImageListが作成され、少なくともImage 1 つが割り当てられている必要があります。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 'AddMyImage

注釈

プロパティまたはImageListプロパティが設定されImageている場合、プロパティは既定値nullのに設定されます。 ImageIndexWhen the ImageIndex or ImageList properties are set, the Image property is set to its default value, null.

注意

プロパティ値がにnull変更された場合ImageIndex 、プロパティは既定値の-1 を返します。 ImageListIf 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 ImageIndexImageList.ImageCollection.Count割り当てられた新しいに、プロパティに割り当てられている値以下のプロパティ値がある場合 (コレクションが0から始まるインデックスである場合)、 ImageList 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. たとえば、3つのイメージImageListがあり、その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.

適用対象

こちらもご覧ください