ImageList.ImageCollection.AddStrip(Image) Méthode

Définition

Espace de noms:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll
Source:
ImageList.ImageCollection.cs
Source:
ImageList.ImageCollection.cs
Source:
ImageList.ImageCollection.cs
Source:
ImageList.ImageCollection.cs
Source:
ImageList.ImageCollection.cs

Ajoute une bande d’images pour l’image spécifiée à l’objet ImageList.

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

Paramètres

value
Image

Avec Bitmap les images à ajouter.

Retours

Int32

Index de l’image nouvellement ajoutée ou -1 si l’image ne peut pas être ajoutée.

Exceptions

ArgumentException

L’image ajoutée est null.

- ou -

L’image ajoutée n’est pas un Bitmap.

InvalidOperationException

Impossible d’ajouter l’image.

- ou -

La largeur de la bande d’image ajoutée est 0, ou la largeur n’est pas égale à la largeur de l’image existante.

- ou -

La hauteur de bande d’image n’est pas égale à la hauteur d’image existante.

Exemples

L’exemple suivant montre comment utiliser AddStrip. Pour exécuter cet exemple, collez le code suivant dans un formulaire Windows qui contient un ImageList nommé imageList1 et un bouton et appelez la méthode AddStripToCollection dans cet exemple lors de la gestion de l'événement Click du bouton.

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

Remarques

Le nombre d’images à ajouter est déduit de la largeur de l’image donnée.

Une bande est une image unique qui est traitée comme plusieurs images organisées côte à côte.

S’applique à