ImageList.ImageCollection.Add 方法

定義

命名空間:

System.Windows.Forms

組件:

System.Windows.Forms.dll

將指定的物件 ImageList加入 。

多載

名稱	Description
Add(Icon)	將指定的圖示加入 ImageList。
Add(Image)	將指定的影像加入 ImageList。
Add(Image, Color)	將指定的影像加入 ImageList，使用指定顏色生成遮罩。
Add(String, Icon)	在集合末端新增一個帶有指定鍵的圖示。
Add(String, Image)	將指定鍵的圖片加入集合末尾。

Add(Icon)

來源:

ImageList.ImageCollection.cs

將指定的圖示加入 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的按鈕的表單中。 範例假設存在 FeatherTexture.bmp 和 c：\Windows\ 處的 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 將 轉換為 a Bitmap 。

Add(Image)

來源:

ImageList.ImageCollection.cs

將指定的影像加入 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.ImageCollection.cs

將指定的影像加入 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)

來源:

ImageList.ImageCollection.cs

在集合末端新增一個帶有指定鍵的圖示。

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)

來源:

ImageList.ImageCollection.cs

將指定鍵的圖片加入集合末尾。

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中的鍵。 圖片鍵不區分大小寫。