ImageList.ImageCollection.Add Methode

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Fügt das angegebene Objekt dem ImageList.

Überlädt

Name	Beschreibung
Add(Icon)	Fügt das angegebene Symbol der ImageList.
Add(Image)	Fügt das angegebene Bild der ImageList.
Add(Image, Color)	Fügt das angegebene Bild mithilfe der angegebenen Farbe zum Generieren der Maske hinzu ImageList.
Add(String, Icon)	Fügt am Ende der Auflistung ein Symbol mit dem angegebenen Schlüssel hinzu.
Add(String, Image)	Fügt am Ende der Auflistung ein Bild mit dem angegebenen Schlüssel hinzu.

Add(Icon)

Quelle:

ImageList.ImageCollection.cs

Fügt das angegebene Symbol der 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)

Parameter

value

Icon

Eine Icon , die der Liste hinzugefügt werden soll.

Ausnahmen

ArgumentNullException

value ist null

- oder -

wert ist kein Icon.

Beispiele

Im folgenden Codebeispiel wird das Erstellen einer , das Hinzufügen von ImageListBildern zur Images Eigenschaft, das Festlegen der ImageSize Eigenschaft und die Verwendung der Draw Methode veranschaulicht. Wenn Sie dieses Beispiel ausführen möchten, platzieren Sie es in einem Formular, das eine Schaltfläche mit dem Namen Button1enthält. Im Beispiel wird davon ausgegangen, dass FeatherTexture.bmp und Gone Fishing.bmp unter c:\Windows\vorhanden sind. Ändern Sie das Beispiel entsprechend, wenn die Bitmaps nicht auf Ihrem System vorhanden sind oder an einem anderen Speicherort vorhanden sind.

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

Hinweise

Die Icon Datei wird in eine Bitmap konvertiert, bevor sie der Liste hinzugefügt wird.

Add(Image)

Quelle:

ImageList.ImageCollection.cs

Fügt das angegebene Bild der 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)

Parameter

value

Image

Ein Bitmap Bild, das der Liste hinzugefügt werden soll.

Ausnahmen

ArgumentNullException

Das hinzugefügte Bild ist null.

ArgumentException

Das hinzugefügte Bild ist kein Bitmap.

Add(Image, Color)

Quelle:

ImageList.ImageCollection.cs

Fügt das angegebene Bild mithilfe der angegebenen Farbe zum Generieren der Maske hinzu 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

Parameter

value

Image

Ein Bitmap Bild, das der Liste hinzugefügt werden soll.

transparentColor

Color

Zum Maskieren dieses Bilds Color .

Gibt zurück

Int32

Der Index des neu hinzugefügten Bilds oder -1, wenn das Bild nicht hinzugefügt werden kann.

Ausnahmen

ArgumentNullException

Das hinzugefügte Bild ist null.

ArgumentException

Das hinzugefügte Bild ist kein Bitmap.

Add(String, Icon)

Quelle:

ImageList.ImageCollection.cs

Fügt am Ende der Auflistung ein Symbol mit dem angegebenen Schlüssel hinzu.

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)

Parameter

key

String

Der Name des Symbols.

icon

Icon

Das Icon , das der Auflistung hinzugefügt werden soll.

Ausnahmen

ArgumentNullException

icon ist null.

Hinweise

Der Name eines Bilds entspricht seinem Schlüssel in der ImageList.ImageCollection. Bei einem Bildschlüssel wird die Groß-/Kleinschreibung nicht beachtet.

Add(String, Image)

Quelle:

ImageList.ImageCollection.cs

Fügt am Ende der Auflistung ein Bild mit dem angegebenen Schlüssel hinzu.

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)

Parameter

key

String

Der Name des Bilds.

image

Image

Das Image , das der Auflistung hinzugefügt werden soll.

Ausnahmen

ArgumentNullException

image ist null.

Hinweise

Der Name eines Bilds entspricht seinem Schlüssel in der ImageList.ImageCollection. Bei einem Bildschlüssel wird die Groß-/Kleinschreibung nicht beachtet.