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 の使用方法を示しています。 この例を実行するには、名前付き imageList1 ボタンと ボタンを含む Windows フォームに次のコードをImageList貼り付け、ボタンの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

注釈

追加するイメージの数は、指定されたイメージの幅から推測されます。

ストリップは、並べて配置された複数の画像として扱われる 1 つの画像です。