Udostępnij za pośrednictwem

ImageList.ImageCollection.Add Metoda

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Windows.Forms
Zestaw:
System.Windows.Forms.dll

Dodaje określony obiekt do obiektu ImageList.

Przeciążenia

Add(Icon)

Dodaje określoną ikonę do elementu ImageList.
Add(Image)

Dodaje określony obraz do elementu ImageList.
Add(Image, Color)

Dodaje określony obraz do ImageListelementu , używając określonego koloru w celu wygenerowania maski.
Add(String, Icon)

Dodaje ikonę z określonym kluczem na końcu kolekcji.
Add(String, Image)

Dodaje obraz z określonym kluczem na końcu kolekcji.

Add(Icon)

Dodaje określoną ikonę do elementu 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)

Parametry

value
Icon

Element Icon do dodania do listy.

Wyjątki

ArgumentNullException

value to null

-lub- wartość nie jest wartością Icon.

Przykłady

Poniższy przykład kodu przedstawia konstruowanie ImageList, dodawanie obrazów do Images właściwości, ustawianie ImageSize właściwości i używanie Draw metody . Aby uruchomić ten przykład, umieść go w formularzu zawierającym przycisk o nazwie Button1. W przykładzie założono istnienie FeatherTexture.bmp i Gone Fishing.bmp w lokalizacji c:\Windows\. Zmień przykład odpowiednio, jeśli mapy bitowe nie istnieją w systemie lub istnieją w innej lokalizacji.

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

Uwagi

Element Icon jest konwertowany na element Bitmap przed dodaniu go do listy.

Dotyczy

Add(Image)

Dodaje określony obraz do elementu 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)

Parametry

value
Image

Obraz Bitmap do dodania do listy.

Wyjątki

ArgumentNullException

Dodawany obraz to null.

ArgumentException

Dodany obraz nie jest elementem Bitmap.

Dotyczy

Add(Image, Color)

Dodaje określony obraz do ImageListelementu , używając określonego koloru w celu wygenerowania maski.

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

Parametry

value
Image

Obraz Bitmap do dodania do listy.

transparentColor
Color

Element Color do maskowania tego obrazu.

Zwraca

Int32

Indeks nowo dodanego obrazu lub -1, jeśli nie można dodać obrazu.

Wyjątki

ArgumentNullException

Dodawany obraz to null.

ArgumentException

Dodany obraz nie jest elementem Bitmap.

Dotyczy

Add(String, Icon)

Dodaje ikonę z określonym kluczem na końcu kolekcji.

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)

Parametry

key
String

Nazwa ikony.

icon
Icon

Element Icon do dodania do kolekcji.

Wyjątki

ArgumentNullException

icon to null.

Uwagi

Nazwa obrazu odpowiada jego kluczowi w elemecie ImageList.ImageCollection. Klucz obrazu nie jest uwzględniany wielkości liter.

Dotyczy

Add(String, Image)

Dodaje obraz z określonym kluczem na końcu kolekcji.

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)

Parametry

key
String

Nazwa obrazu.

image
Image

Element Image do dodania do kolekcji.

Wyjątki

ArgumentNullException

image to null.

Uwagi

Nazwa obrazu odpowiada jego kluczowi w elemecie ImageList.ImageCollection. Klucz obrazu nie jest uwzględniany wielkości liter.

Dotyczy