ImageList.ImageCollection.Add 메서드

정의

지정된 개체를 ImageList에 추가합니다.Adds the specified object to the ImageList.

오버로드

Add(Icon)

지정된 아이콘을 ImageList에 추가합니다.Adds the specified icon to the ImageList.

Add(Image)

지정된 이미지를 ImageList에 추가합니다.Adds the specified image to the ImageList.

Add(Image, Color)

지정된 이미지를 ImageList에 추가하고 지정된 색을 사용하여 마스크를 생성시킵니다.Adds the specified image to the ImageList, using the specified color to generate the mask.

Add(String, Icon)

컬렉션의 끝에 지정한 키가 있는 아이콘을 추가합니다.Adds an icon with the specified key to the end of the collection.

Add(String, Image)

컬렉션의 끝에 지정된 된 키를 사용 하 여 이미지를 추가합니다.Adds an image with the specified key to the end of the collection.

Add(Icon)

지정된 아이콘을 ImageList에 추가합니다.Adds the specified icon to the 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입니다.An Icon to add to the list.

예외

valuenull인 경우value is null

-또는--or- 값이 Icon이 아닌 경우value is not an Icon.

예제

다음 코드 예제에서는 ImageList를 생성 하 고, Images 속성에 이미지를 추가 하 고, ImageSize 속성을 설정 하 고, Draw 메서드를 사용 하는 방법을 보여 줍니다.The following code example demonstrates constructing an ImageList, adding images to the Images property, setting the ImageSize property, and using the Draw method. 이 예제를 실행 하려면 Button1이라는 단추가 포함 된 양식에 넣습니다.To run this example, place it in a form that contains a button named Button1. 이 예제에서는 FeatherTexture이 존재 하 고 c:\Windows를 c:\Windows\에 있는 것으로 가정 합니다.The example assumes the existence of FeatherTexture.bmp and Gone Fishing.bmp at c:\Windows\. 비트맵에 시스템에 존재 하지 않거나 다른 위치에 존재 하는 경우에 예제를 적절 하 게 변경 합니다.Change the example accordingly if the bitmaps do not exist on your system or exist at another location.

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으로 변환 됩니다.The Icon is converted to a Bitmap before it is added to the list.

Add(Image)

지정된 이미지를 ImageList에 추가합니다.Adds the specified image to the 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입니다.A Bitmap of the image to add to the list.

예외

추가되는 이미지가 null인 경우The image being added is null.

추가되는 이미지가 Bitmap이 아닌 경우The image being added is not a Bitmap.

Add(Image, Color)

지정된 이미지를 ImageList에 추가하고 지정된 색을 사용하여 마스크를 생성시킵니다.Adds the specified image to the ImageList, using the specified color to generate the mask.

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입니다.A Bitmap of the image to add to the list.

transparentColor
Color

해당 이미지를 마스킹할 Color입니다.The Color to mask this image.

반환

인덱스는 새로 추가 된 이미지 또는 이미지를 추가할 수 없는 경우-1입니다.The index of the newly added image, or -1 if the image cannot be added.

예외

추가되는 이미지가 null인 경우The image being added is null.

추가되는 이미지가 Bitmap이 아닌 경우The image being added is not a Bitmap.

Add(String, Icon)

컬렉션의 끝에 지정한 키가 있는 아이콘을 추가합니다.Adds an icon with the specified key to the end of the collection.

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

매개 변수

key
String

아이콘의 이름입니다.The name of the icon.

icon
Icon

컬렉션에 추가할 Icon입니다.The Icon to add to the collection.

예외

iconnull인 경우icon is null.

설명

이미지 이름은 ImageList.ImageCollection의 해당 키에 해당 합니다.The name of an image corresponds to its key in the ImageList.ImageCollection. 이미지 키 대/소문자 구분 아닙니다.An image key is not case-sensitive.

Add(String, Image)

컬렉션의 끝에 지정된 된 키를 사용 하 여 이미지를 추가합니다.Adds an image with the specified key to the end of the collection.

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

매개 변수

key
String

이미지의 이름입니다.The name of the image.

image
Image

컬렉션에 추가할 Image입니다.The Image to add to the collection.

예외

imagenull인 경우image is null.

설명

이미지 이름은 ImageList.ImageCollection의 해당 키에 해당 합니다.The name of an image corresponds to its key in the ImageList.ImageCollection. 이미지 키 대/소문자 구분 아닙니다.An image key is not case-sensitive.

적용 대상