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; }
member this.ImageList : System.Windows.Forms.ImageList with get, set
Public Property ImageList As ImageList

プロパティ値

ImageList

ImageList。 既定値は null です。

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

注釈

プロパティまたは ImageList プロパティ ImageIndex が設定されている場合、プロパティ Image は 既定値である null に設定されます。

注意

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

適用対象

こちらもご覧ください