ButtonBase.ImageIndex プロパティ

定義

ボタン コントロールに表示されているイメージのイメージ リスト内でのインデックス値を取得または設定します。

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 内でのイメージの位置を表す 0 から始まるインデックス。 既定値は -1 です。

属性

例外

value が -1 未満です。

次のコード例では、派生クラスを使用して、 Button ImageList プロパティとプロパティを設定し ImageIndex ます。 このコードでは、 が ImageList 作成され、少なくとも 1 つが割 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 ます。

ImageKeyImageIndex は相互に排他的です。つまり、設定されている場合、もう一方は無効な値に設定され、無視されます。 プロパティを設定した場合 ImageKeyImageIndex プロパティは自動的に-1 に設定されます。 また、プロパティを設定した場合は、 ImageIndex ImageKey が自動的に空の文字列 ("") に設定されます。

ImageListプロパティ値がに変更された場合 nullImageIndex プロパティは既定値の-1 を返します。 ただし、割り当てられた ImageIndex 値は内部で保持され、別の ImageList オブジェクトがプロパティに割り当てられるときに使用され ImageList ます。 プロパティに割り当てられた新しいに、プロパティ ImageList ImageList ImageList.ImageCollection.Count に割り当てられている値以下のプロパティ値がある場合 ImageIndex (コレクションが0から始まるインデックスの場合)、プロパティ値 ImageIndex はプロパティ値よりも1小さい値に調整され Count ます。 たとえば、 ImageList 3 つのイメージがあり、その ImageIndex プロパティが2に設定されているボタンコントロールがあるとします。 ImageList2 つのイメージのみを持つ新しいがボタンに割り当てられている場合、 ImageIndex 値は1に変更されます。

適用対象

こちらもご覧ください