ImageList.ImageCollection.AddStrip(Image) Methode

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Fügt der ImageList einen Bildstreifen des angegebenen Bildes hinzu.

public:
 int AddStrip(System::Drawing::Image ^ value);

public int AddStrip (System.Drawing.Image value);

member this.AddStrip : System.Drawing.Image -> int

Public Function AddStrip (value As Image) As Integer

Parameter

value

Image

Eine Bitmap mit den hinzuzufügenden Bildern.

Gibt zurück

Int32

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

Ausnahmen

ArgumentException

Das gerade hinzugefügte Bild ist null.

- oder -

Das derzeit hinzugefügte Bild ist keine Bitmap.

InvalidOperationException

Das Bild kann nicht hinzugefügt werden.

- oder -

Die Breite des hinzugefügten Bildstreifens ist 0 oder ist ungleich der Breite des vorhandenen Bildes.

- oder -

Die Höhe des Grafikstreifens ist nicht gleich der Höhe des vorhandenen Bildes.

Beispiele

Im folgenden Beispiel wird die Verwendung von AddStripveranschaulicht. Fügen Sie zum Ausführen dieses Beispiels den folgenden Code in ein Windows Form-Formular ein, das eine ImageList benannte imageList1 und eine Schaltfläche enthält, und rufen Sie die AddStripToCollection -Methode in diesem Beispiel auf, wenn Sie das Ereignis der Schaltfläche Click behandeln.

public void AddStripToCollection()
{
    // Add the image strip.
    Bitmap bitmaps = new Bitmap(typeof(PrintPreviewDialog), "PrintPreviewStrip.bmp");
    imageList1.Images.AddStrip(bitmaps);
    
    // Iterate through the images and display them on the form.
    for (int i = 0; i < imageList1.Images.Count; i++) {
    
        imageList1.Draw(this.CreateGraphics(), new Point(10,10), i);
        Application.DoEvents();
        System.Threading.Thread.Sleep(1000);
    }
}

Private Sub AddStripToCollection() 
    ' Add the image strip.
    Dim bitmaps As New Bitmap(GetType(PrintPreviewDialog), "PrintPreviewStrip.bmp")
    imageList1.Images.AddStrip(bitmaps)
    
    ' Iterate through the images and display them on the form.
    For i As Integer = 0 To imageList1.Images.Count - 1
        
        imageList1.Draw(Me.CreateGraphics(), New Point(10, 10), i)
        Application.DoEvents()
        System.Threading.Thread.Sleep(1000)
    Next
 
End Sub

Hinweise

Die Anzahl der hinzuzufügenden Bilder wird aus der Breite des angegebenen Bilds abgeleitet.

Ein Streifen ist ein einzelnes Bild, das als mehrere nebeneinander angeordnete Bilder behandelt wird.