ImageList.ImageCollection.Add メソッド

リファレンス

定義

名前空間:: System.Windows.Forms

アセンブリ:: System.Windows.Forms.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

指定したオブジェクトを ImageList に追加します。

オーバーロード

Add(Icon)	指定したアイコンを ImageList に追加します。
Add(Image)	指定したイメージを ImageList に追加します。
Add(Image, Color)	指定した色を使用してマスクを生成し、指定したイメージを ImageList に追加します。
Add(String, Icon)	指定したキーのアイコンをコレクションの末尾に追加します。
Add(String, Image)	指定したキーのイメージをコレクションの末尾に追加します。

Add(Icon)

指定したアイコンを ImageList に追加します。

public:
 void Add(System::Drawing::Icon ^ value);

public void Add (System.Drawing.Icon value);

member this.Add : System.Drawing.Icon -> unit

Public Sub Add (value As Icon)

パラメーター

value: Icon

リストに追加する Icon。

例外

ArgumentNullException

value は null です

- または -

値が Icon ではありません。

例

次のコード例では、を構築し ImageList、プロパティにイメージを追加し Images 、プロパティを ImageSize 設定し、メソッドを使用する方法を Draw 示します。この例を実行するには、という名前 Button1のボタンを含むフォームに配置します。この例では、c:\Windows\ に FeatherTexture.bmp と Gone Fishing.bmpが存在することを前提としています。ビットマップがシステム上に存在しないか、別の場所に存在する場合は、それに応じて例を変更します。

internal:
   System::Windows::Forms::ImageList^ ImageList1;

private:

   // Create an ImageList Object, populate it, and display
   // the images it contains.
   void Button1_Click( System::Object^ /*sender*/, System::EventArgs^ /*e*/ )
   {
      
      // Construct the ImageList.
      ImageList1 = gcnew ImageList;
      
      // Set the ImageSize property to a larger size 
      // (the default is 16 x 16).
      ImageList1->ImageSize = System::Drawing::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, 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 );

      }
   }

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

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

注釈

Iconは、リストにBitmap追加される前にに変換されます。

適用対象

Add(Image)

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

public:
 void Add(System::Drawing::Image ^ value);

public void Add (System.Drawing.Image value);

member this.Add : System.Drawing.Image -> unit

Public Sub Add (value As Image)

パラメーター

value: Image

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

例外

ArgumentNullException

追加しようとしているイメージが null です。

ArgumentException

追加しようとしているイメージが Bitmap ではありません。

適用対象

Add(Image, Color)

指定した色を使用してマスクを生成し、指定したイメージを ImageList に追加します。

public:
 int Add(System::Drawing::Image ^ value, System::Drawing::Color transparentColor);

public int Add (System.Drawing.Image value, System.Drawing.Color transparentColor);

member this.Add : System.Drawing.Image * System.Drawing.Color -> int

Public Function Add (value As Image, transparentColor As Color) As Integer

パラメーター

value: Image

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

transparentColor: Color

イメージをマスクする Color。

戻り値

Int32

新しく追加したイメージのインデックス。イメージを追加できなかった場合は -1。

例外

ArgumentNullException

追加しようとしているイメージが null です。

ArgumentException

追加しようとしているイメージが Bitmap ではありません。

適用対象

Add(String, Icon)

指定したキーのアイコンをコレクションの末尾に追加します。

public:
 void Add(System::String ^ key, System::Drawing::Icon ^ icon);

public void Add (string key, System.Drawing.Icon icon);

member this.Add : string * System.Drawing.Icon -> unit

Public Sub Add (key As String, icon As Icon)

パラメーター

key: String

アイコンの名前。

icon: Icon

コレクションに追加する Icon。

例外

ArgumentNullException

icon が nullです。

注釈

イメージの名前は、内のキーに ImageList.ImageCollection対応します。イメージキーでは大文字と小文字は区別されません。

適用対象

Add(String, Image)

指定したキーのイメージをコレクションの末尾に追加します。

public:
 void Add(System::String ^ key, System::Drawing::Image ^ image);

public void Add (string key, System.Drawing.Image image);

member this.Add : string * System.Drawing.Image -> unit

Public Sub Add (key As String, image As Image)

パラメーター

key: String

イメージの名前。

image: Image

コレクションに追加する Image。

例外

ArgumentNullException

image が nullです。

注釈

イメージの名前は、内のキーに ImageList.ImageCollection対応します。イメージキーでは大文字と小文字は区別されません。

適用対象

ImageList.ImageCollection.Add メソッド

定義

オーバーロード

Add(Icon)

パラメーター

例外

例

注釈

適用対象

Add(Image)

パラメーター

例外

適用対象

Add(Image, Color)

パラメーター

戻り値

例外

適用対象

Add(String, Icon)

パラメーター

例外

注釈

適用対象

Add(String, Image)

パラメーター

例外

注釈

適用対象

フィードバック

その他のリソース