Freigeben über


ImageList.ImageCollection.AddStrip-Methode

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

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)

Syntax

'Declaration
Public Function AddStrip ( _
    value As Image _
) As Integer
'Usage
Dim instance As ImageCollection
Dim value As Image
Dim returnValue As Integer

returnValue = instance.AddStrip(value)
public int AddStrip (
    Image value
)
public:
int AddStrip (
    Image^ value
)
public int AddStrip (
    Image value
)
public function AddStrip (
    value : Image
) : int

Parameter

  • value
    Eine Bitmap mit den hinzuzufügenden Bildern.

Rückgabewert

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

Ausnahmen

Ausnahmetyp Bedingung

ArgumentException

Das gerade hinzugefügte Bild ist NULL (Nothing in Visual Basic).

- 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.

Hinweise

Die Anzahl der hinzuzufügenden Bilder wird aus der Breite des angegebenen Bildes hergeleitet.

Ein Grafikstreifen ist ein einzelnes Bild, das wie mehrere nebeneinander angeordnete Bilder behandelt wird.

Beispiel

Das folgende Beispiel veranschaulicht die Verwendung von AddStrip. Fügen Sie zum Ausführen dieses Beispiels den folgenden Code in ein Windows Form ein, das eine ImageList mit dem Namen imageList1 und eine Schaltfläche enthält, und rufen Sie die AddStripToCollection-Methode in diesem Beispiel beim Behandeln des Click-Ereignisses der Schaltfläche auf.

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.
    Dim i As Integer
    For i = 0 To imageList1.Images.Count
        
        imageList1.Draw(Me.CreateGraphics(), New Point(10, 10), i)
        Application.DoEvents()
        System.Threading.Thread.Sleep(1000)
    Next i
 
End Sub


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);
        
    }
    

}
public:
    void AddStripToCollection()
    {
        // Add the image strip.
        Bitmap^ bitmaps = gcnew Bitmap(PrintPreviewDialog::typeid,
            "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(), Point(10,10), i);
            Application::DoEvents();
            System::Threading::Thread::Sleep(1000);
        }
    }

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

ImageList.ImageCollection-Klasse
ImageList.ImageCollection-Member
System.Windows.Forms-Namespace