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。 若要运行此示例，请将以下代码粘贴到包含ImageList命名imageList1按钮和按钮的 Windows 窗体中，并在处理按钮Click的事件时调用AddStripToCollection此示例中的 方法。

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

注解

从给定图像的宽度推断要添加的图像数。

条带是被视为并排排列的多个图像的单个图像。