ImageList.ImageCollection.AddStrip(Image) Метод

Определение

Пространство имен:

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

Добавляет полосу изображений для указанного изображения в 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

Параметры

value

Image

Объект Bitmap, содержащий добавляемые изображения.

Возвращаемое значение

Int32

Индекс добавляемого изображения или -1, если добавить изображение не удалось.

Исключения

ArgumentException

Добавляемое изображение является null.

-или-

Добавляемое изображение не является Bitmap.

InvalidOperationException

Изображение не может быть добавлено.

-или-

Ширина добавленной полосы изображений равна 0 или не равна ширине существующего изображения.

-или-

Высота добавленной полосы изображений не равна высоте существующего изображения.

Примеры

В следующем примере показано, как использовать AddStrip. Чтобы выполнить этот пример, вставьте следующий код в форму Windows Forms, содержащую ImageList имена imageList1 и кнопку, и вызовите AddStripToCollection метод в этом примере при обработке события кнопки Click .

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

Комментарии

Количество добавляемых изображений определяется на основе ширины данного изображения.

Полоса — это одно изображение, которое обрабатывается как несколько изображений, расположенных рядом.