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

属性

TypeConverterAttribute

例外

ArgumentOutOfRangeException

value が -1 未満です。

例

次のコード例では、 派生クラスを使用し、 Button プロパティと ImageIndex プロパティをImageList設定します。 このコードでは、 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設定すると、 Image プロパティは既定値 に設定されますnull。ImageList

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

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

こちらもご覧ください

• ImageList