ImageList.ImageCollection.AddStrip メソッドとは何？わかりやすく解説 Weblio辞書

.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)

public int AddStrip (
    Image value
)

C++

public:
int AddStrip (
    Image^ value
)

public int AddStrip (
    Image value
)

JScript

public function AddStrip (
    value : Image
) : int

パラメータ

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

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

例外

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

例外の種類

条件

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

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