ButtonBase.ImageList ButtonBase.ImageList ButtonBase.ImageList ButtonBase.ImageList Property

定義

ボタン コントロールに表示される ImageList を保持している Image を取得または設定します。Gets or sets the ImageList that contains the Image displayed on a button control.

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

プロパティ値

ImageListAn ImageList. 既定値は null です。The default value is null.

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

注釈

プロパティまたはImageIndexプロパティを設定すると、 nullプロパティが設定されます。これは既定値です。 Image ImageListWhen the ImageList or ImageIndex property is set, the Image property is set null, which is its default value.

注意

プロパティ値がに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 is assigned to the ImageList property. ImageListプロパティImageIndex ImageIndexImageList.ImageCollection.Count割り当てられた新しいに、プロパティに割り当てられた値以下のプロパティ値がある場合 (コレクションが0から始まるインデックスであるため)、 ImageListプロパティ値は、 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 (because the collection is 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.

適用対象

こちらもご覧ください