ImageList.ImageCollection.AddStrip(Image) Método

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Adiciona uma faixa de imagem para a imagem especificada ao 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

Um Bitmap com as imagens a serem adicionadas.

Retornos

Int32

O índice da imagem recém-adicionada ou então -1, se a imagem não pode ser adicionada.

Exceções

ArgumentException

A imagem que está sendo adicionada é null.

- ou -

A imagem que está sendo adicionada não é um Bitmap.

InvalidOperationException

A imagem não pode ser adicionada.

- ou -

A largura da faixa de imagens que está sendo adicionada é 0 ou a largura não é igual à largura da imagem existente.

- ou -

A altura da faixa de imagem não é igual à altura da imagem existente.

Exemplos

O exemplo a seguir demonstra como usar AddStrip. Para executar este exemplo, cole o código a seguir em um Formulário do Windows que contém um ImageList nome imageList1 e um botão e chame o AddStripToCollection método neste exemplo ao manipular o evento do Click botão.

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

Comentários

O número de imagens a serem adicionadas é inferido da largura da imagem fornecida.

Uma faixa é uma única imagem que é tratada como várias imagens organizadas lado a lado.