ImageList.ImageCollection.AddStrip(Image) Methode

Definition

Fügt dem angegebenen Bild ImageListeinen Bildstreifen 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

A Bitmap mit den hinzuzufügenden Bildern.

Gibt zurück

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

Ausnahmen

Das hinzugefügte Bild ist null.

-oder-

Das hinzugefügte Bild ist kein Bitmap.

Das Bild kann nicht hinzugefügt werden.

-oder-

Die Breite des hinzugefügten Bildstreifens ist 0, oder die Breite ist nicht gleich der vorhandenen Bildbreite.

-oder-

Die Höhe des Bildstreifens entspricht nicht der vorhandenen Bildhöhe.

Beispiele

Im folgenden Beispiel wird die Verwendung AddStripveranschaulicht. Zum Ausführen dieses Beispiels fügen Sie den folgenden Code in ein Windows Formular ein, das einen ImageList mit dem Namen imageList1 und eine Schaltfläche enthält, und rufen Sie die methode AddStripToCollection in diesem Beispiel auf, wenn das ereignis Click der Schaltfläche behandelt wird.

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 von der Breite des angegebenen Bilds abgeleitet.

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

Gilt für: