ImageList.ImageCollection.AddStrip メソッド

.NET Framework クラス ライブラリ リファレンス

ImageList.ImageCollection.AddStrip メソッド

指定したイメージのイメージ ストリップを ImageList に追加します。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

Public Function AddStrip ( _
    value As Image _
) As Integer

Visual Basic (使用法)

Dim instance As ImageCollection
Dim value As Image
Dim returnValue As Integer

returnValue = instance.AddStrip(value)

C#

public int AddStrip (
    Image value
)

C++

public:
int AddStrip (
    Image^ value
)

J#

public int AddStrip (
    Image value
)

JScript

public function AddStrip (
    value : Image
) : int

パラメータ

value

追加するイメージを含む Bitmap。

戻り値
新しく追加したイメージのインデックス。イメージを追加できなかった場合は -1。

例外

例外の種類	条件
ArgumentException	追加しようとしているイメージが null 参照 (Visual Basic では Nothing) です。 または 追加しようとしているイメージが Bitmap ではありません。
InvalidOperationException	イメージを追加できません。 または 追加されるイメージ ストリップの幅が 0 か、または既存のイメージの幅と等しくありません。 または イメージ ストリップの高さが既存のイメージの高さと等しくありません。

解説

追加されるイメージの数は、指定したイメージの幅を基に決定されます。

ストリップは、複数のイメージが並べて配置されたものとして扱われる単一のイメージです。

使用例

AddStrip を使用する方法を次の例に示します。この例を実行するには、imageList1 という名前の ImageList とボタンが配置されている Windows フォームに次のコードを貼り付け、このボタンの Click イベントを処理する際に AddStripToCollection メソッドを呼び出します。

Visual Basic

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.
    Dim i As Integer
    For i = 0 To imageList1.Images.Count
        
        imageList1.Draw(Me.CreateGraphics(), New
 Point(10, 10), i)
        Application.DoEvents()
        System.Threading.Thread.Sleep(1000)
    Next i
 
End Sub

C#

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);
        
    }
    

}

C++

public:
    void AddStripToCollection()
    {
        // Add the image strip.
        Bitmap^ bitmaps = gcnew Bitmap(PrintPreviewDialog::typeid,
            "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(), Point(10,10),
 i);
            Application::DoEvents();
            System::Threading::Thread::Sleep(1000);
        }
    }

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
ImageList.ImageCollection クラス
ImageList.ImageCollection メンバ
System.Windows.Forms 名前空間