ButtonBase.ImageList プロパティ

定義

ボタン コントロールに表示される ImageList を保持している Image を取得または設定します。

public:
 property System::Windows::Forms::ImageList ^ ImageList { System::Windows::Forms::ImageList ^ get(); void set(System::Windows::Forms::ImageList ^ value); };
public System.Windows.Forms.ImageList ImageList { get; set; }
public System.Windows.Forms.ImageList? ImageList { get; set; }
member this.ImageList : System.Windows.Forms.ImageList with get, set
Public Property ImageList As ImageList

プロパティ値

ImageList。 既定値は null です。

次のコード例では、 派生クラスを使用し、 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

注釈

または プロパティをImageList設定すると、 Image プロパティが設定nullされます。これは既定値ImageIndexです。

注意

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

適用対象

こちらもご覧ください