ImageList.ImageCollection.AddStrip(Image) Método

Definición

Espacio de nombres:

System.Windows.Forms

Ensamblado:

System.Windows.Forms.dll

Agrega una banda de imagen a la imagen especificada del control 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

Parámetros

value

Image

Control Bitmap con las imágenes que se van a agregar.

Devoluciones

Int32

Índice de la nueva imagen que se ha agregado, o -1 si no se ha podido agregar la imagen en cuestión.

Excepciones

ArgumentException

La imagen que se está agregando es null.

o bien

La imagen que se está agregando no es Bitmap.

InvalidOperationException

No se puede agregar la imagen.

o bien

El ancho de la banda de imagen que se está agregando es 0, o el ancho no es igual al ancho de imagen existente.

o bien

El alto de la banda de imagen no es igual al alto de imagen existente.

Ejemplos

En el ejemplo siguiente se muestra cómo usar AddStrip. Para ejecutar este ejemplo, pegue el código siguiente en un formulario Windows Forms que contenga un ImageList nombre imageList1 y un botón y llame al AddStripToCollection método en este ejemplo al controlar el evento del Click botón.

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

Comentarios

El número de imágenes que se van a agregar se deduce del ancho de la imagen especificada.

Una tira es una sola imagen que se trata como varias imágenes organizadas en paralelo.