ImageList.ImageCollection.Add メソッド (Image)

指定したイメージを ImageList に追加します。

Overloads Public Sub Add( _
   ByVal value As Image _)
[C#]
public void Add(Imagevalue);
[C++]
public: void Add(Image* value);
[JScript]
public function Add(
   value : Image);

パラメータ

  • value
    リストに追加するイメージの Bitmap

例外

例外の種類 条件
Exception イメージに対する追加が失敗しました。
ArgumentNullException 追加されているイメージが null 参照 (Visual Basic では Nothing) です。
ArgumentException 追加されているイメージが Bitmap ではありません。

使用例

[Visual Basic, C#] ImageSize プロパティを設定して ImageList を構築し、 System.Windows.Forms.ImageCollection.Add メソッドおよび Draw メソッドを使用する例を次に示します。この例を実行するには、Button1 という名前のボタンが配置されたフォームの中にこの例を配置します。この例では、c:\Windows\ に FeatherTexture.bmp および Gone Fishing.bmp があることを前提としています。これらのビットマップがシステムに存在しない場合、または他の場所に存在する場合は、必要に応じて例を変更してください。Button1 ボタンの click イベントは、この例のイベント処理メソッドに必ず関連付けるようにしてください。

 
Friend WithEvents ImageList1 As System.Windows.Forms.ImageList

' Create an ImageList Object, populate it, and display
' the images it contains.
Private Sub Button1_Click(ByVal sender As System.Object, _
    ByVal e As System.EventArgs) Handles Button1.Click

    ' Construct the ImageList.
    ImageList1 = New ImageList

    ' Set the ImageSize property to a larger size 
    ' (the default is 16 x 16).
    ImageList1.ImageSize = New Size(112, 112)

    ' Add two images to the list.
    ImageList1.Images.Add(Image.FromFile _
        ("c:\windows\FeatherTexture.bmp"))
    ImageList1.Images.Add _
        (Image.FromFile("C:\windows\Gone Fishing.bmp"))

    Dim count As System.Int32

    ' Get a Graphics object from the form's handle.
    Dim theGraphics As Graphics = Graphics.FromHwnd(Me.Handle)

    ' Loop through the images in the list, drawing each image.
    For count = 0 To ImageList1.Images.Count - 1
        ImageList1.Draw(theGraphics, New Point(85, 85), count)

        ' Call Application.DoEvents to force a repaint of the form.
        Application.DoEvents()

        ' Call the Sleep method to allow the user to see the image.
        System.Threading.Thread.Sleep(1000)
    Next
End Sub


[C#] 
internal System.Windows.Forms.ImageList ImageList1;

// Create an ImageList Object, populate it, and display
// the images it contains.
private void Button1_Click(System.Object sender, 
    System.EventArgs e)
{

    // Construct the ImageList.
    ImageList1 = new ImageList();

    // Set the ImageSize property to a larger size 
    // (the default is 16 x 16).
    ImageList1.ImageSize = new Size(112, 112);

    // Add two images to the list.
    ImageList1.Images.Add(
        Image.FromFile("c:\\windows\\FeatherTexture.bmp"));
    ImageList1.Images.Add(
        Image.FromFile("C:\\windows\\Gone Fishing.bmp"));

    // Get a Graphics object from the form's handle.
    Graphics theGraphics = Graphics.FromHwnd(this.Handle);

    // Loop through the images in the list, drawing each image.
    for(int count = 0; count < ImageList1.Images.Count; count++)
    {
        ImageList1.Draw(theGraphics, new Point(85, 85), count);

        // Call Application.DoEvents to force a repaint of the form.
        Application.DoEvents();

        // Call the Sleep method to allow the user to see the image.
        System.Threading.Thread.Sleep(1000);
    }
}

[C++, JScript] C++ および JScript のサンプルはありません。Visual Basic および C# のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン 言語のフィルタ をクリックします。

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ, .NET Compact Framework - Windows CE .NET

参照

ImageList.ImageCollection クラス | ImageList.ImageCollection メンバ | System.Windows.Forms 名前空間 | ImageList.ImageCollection.Add オーバーロードの一覧