ButtonBase.ImageList プロパティとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

ButtonBase.ImageList プロパティ

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

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

Public Property ImageList As
 ImageList

Visual Basic (使用法)

Dim instance As ButtonBase
Dim value As ImageList

value = instance.ImageList

instance.ImageList = value

public ImageList ImageList { get; set;
 }

C++

public:
property ImageList^ ImageList {
    ImageList^ get ();
    void set (ImageList^ value);
}

/** @property */
public ImageList get_ImageList ()

/** @property */
public void set_ImageList (ImageList value)

JScript

public function get ImageList
 () : ImageList

public function set ImageList
 (value : ImageList)

プロパティ値
ImageList。既定値は null 参照 (Visual Basic では Nothing) です。

解説

ImageList プロパティまたは ImageIndex プロパティが設定されている場合は、Image プロパティが既定値の null 参照 (Visual Basic では Nothing) に設定されます。

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

メモ

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

使用例

派生クラス Button を使用して、ImageList プロパティと ImageIndex プロパティを設定するコード例を次に示します。このコードでは、ImageList が作成されており、そこに Image が 1 つ以上割り当てられている必要があります。また、C:\Graphics ディレクトリに MyBitMap.bmp という名前のビットマップイメージが格納されている必要もあります。

Visual Basic

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 'AddMyImage

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;
 }

C++

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.get_Images().Add(Image.FromFile(
        "C:\\Graphics\\MyBitmap.bmp"));
    // Assign the ImageList to the button control.   
    button1.set_ImageList(imageList1);
    // Select the image from the ImageList (using the ImageIndex property).
    
    button1.set_ImageIndex(0);
} //AddMyImage

JScript

private function AddMyImage()
 {
    // Assign an image to the ImageList.
    ImageList1 = new 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;
 }