共用方式為


ImageList.ImageCollection.Add 方法

定義

將指定的物件加入 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

例外狀況

valuenull

-或- 值不是 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

例外狀況

要加入的影像是 null

要加入的影像不是 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。

例外狀況

要加入的影像是 null

要加入的影像不是 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

例外狀況

iconnull

備註

影像的名稱會對應至 中的 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

例外狀況

imagenull

備註

影像的名稱會對應至 中的 ImageList.ImageCollection 索引鍵。 影像索引鍵不區分大小寫。

適用於