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和消失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)

參數

例外狀況

備註

適用於

其他資源