ImageList.ImageCollection.AddStrip(Image) Yöntem

Tanım

Ad Alanı:

System.Windows.Forms

Bütünleştirilmiş Kod:

System.Windows.Forms.dll

belirtilen görüntü için öğesine bir görüntü ImageListşeridi ekler.

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

Parametreler

value

Image

Eklenecek görüntüleri içeren A Bitmap .

Döndürülenler

Int32

Yeni eklenen görüntünün dizini veya görüntü eklenemediğinde -1.

Özel durumlar

ArgumentException

Eklenen görüntü şeklindedir null.

-veya-

Eklenen görüntü bir Bitmapdeğil.

InvalidOperationException

Görüntü eklenemiyor.

-veya-

Eklenen görüntü şeridinin genişliği 0'dır veya genişlik mevcut görüntü genişliğine eşit değildir.

-veya-

Görüntü şeridi yüksekliği mevcut görüntü yüksekliğine eşit değildir.

Örnekler

Aşağıdaki örnekte nasıl kullanılacağı AddStripgösterilmektedir. Bu örneği çalıştırmak için, aşağıdaki kodu adlandırılmış imageList1 ve düğme içeren bir ImageList Windows Formuna yapıştırın ve düğmenin AddStripToCollection olayını işlerken Click bu örnekte yöntemini çağırı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

Açıklamalar

Eklenecek görüntü sayısı, verilen görüntünün genişliğinden çıkarılır.

Şerit, yan yana yerleştirilmiş birden çok resim olarak ele alınan tek bir resimdir.