Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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 |
|---|---|
Das gerade hinzugefügte Bild ist NULL (Nothing in Visual Basic). - oder - Das derzeit hinzugefügte Bild ist keine Bitmap. |
|
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