ImageList.ImageCollection.AddStrip(Image) Méthode

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Ajoute une bande d'image pour l'image spécifiée à 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

Bitmap avec les images à ajouter.

Retours

Int32

Index de la nouvelle image ajoutée ou -1 si l'image n'a pas pu être ajoutée.

Exceptions

ArgumentException

L'image ajoutée est null.

- ou -

L'image ajoutée n'est pas 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 la bande d'image n'est pas égale à la hauteur de l'image existante.

Exemples

L’exemple suivant montre comment utiliser AddStrip. Pour exécuter cet exemple, collez le code suivant dans un Windows Form qui contient un ImageList bouton nommé imageList1 et un bouton, puis appelez la AddStripToCollection méthode dans cet exemple lors de la gestion de l’événement du Click 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 disposées côte à côte.