方法 : Windows フォームの ImageList コンポーネントにイメージを追加または削除する

2011-08-09

Windows フォームの ImageList コンポーネントは、コントロールに関連付ける前にイメージを設定するのが普通です。ただし、イメージリストをコントロールに関連付けた後で、イメージを追加または削除することもできます。

注意

イメージを削除するときには、関連付けられているコントロールの ImageIndex プロパティがイメージの削除後も有効であることを確認してください。

プログラムによってイメージを追加するには

イメージリストの Images プロパティの Add メソッドを使用します。

次のコード例では、イメージの場所に対するパスとして My Documents フォルダーが設定されています。この場所を使用するのは、Windows オペレーティングシステムを実行するコンピューターには、通常このディレクトリが存在すると考えられるためです。また、この場所を選択すると、最小限のシステムアクセスレベルのユーザーがアプリケーションをより安全に実行できます。次のコード例には、ImageList コントロールを追加済みのフォームが必要です。

Public Sub LoadImage()
   Dim myImage As System.Drawing.Image = _
     Image.FromFile _
   (System.Environment.GetFolderPath _
   (System.Environment.SpecialFolder.Personal) _
   & "\Image.gif")
   ImageList1.Images.Add(myImage)
End Sub

public void addImage()
{
// Be sure that you use an appropriate escape sequence (such as the 
// @) when specifying the ___location of the file.
   System.Drawing.Image myImage = 
     Image.FromFile
   (System.Environment.GetFolderPath
   (System.Environment.SpecialFolder.Personal)
   + @"\Image.gif");
   imageList1.Images.Add(myImage);
}

public:
   void addImage()
   {
   // Replace the bold image in the following sample 
   // with your own icon.
   // Be sure that you use an appropriate escape sequence (such as 
   // \\) when specifying the ___location of the file.
      System::Drawing::Image ^ myImage = 
         Image::FromFile(String::Concat(
         System::Environment::GetFolderPath(
         System::Environment::SpecialFolder::Personal),
         "\\Image.gif"));
      imageList1->Images->Add(myImage);
   }

キー値を指定してイメージを追加するには

キー値を引数に受け取る、イメージリストの Images プロパティのいずれかの Add メソッドを使用します。

次のコード例では、イメージの場所に対するパスとして My Documents フォルダーが設定されています。この場所を使用するのは、Windows オペレーティングシステムを実行するコンピューターには、通常このディレクトリが存在すると考えられるためです。また、この場所を選択すると、最小限のシステムアクセスレベルのユーザーがアプリケーションをより安全に実行できます。次のコード例には、ImageList コントロールを追加済みのフォームが必要です。
```
Public Sub LoadImage()
   Dim myImage As System.Drawing.Image = _
     Image.FromFile _
   (System.Environment.GetFolderPath _
   (System.Environment.SpecialFolder.Personal) _
   & "\Image.gif")
   ImageList1.Images.Add("myPhoto", myImage)
End Sub
```

public void addImage()
{
// Be sure that you use an appropriate escape sequence (such as the 
// @) when specifying the ___location of the file.
   System.Drawing.Image myImage = 
     Image.FromFile
   (System.Environment.GetFolderPath
   (System.Environment.SpecialFolder.Personal)
   + @"\Image.gif");
   imageList1.Images.Add("myPhoto", myImage);
}

プログラムによってすべてのイメージを削除するには

Remove メソッドを使用して単一のイメージを削除します。

または

Clear メソッドを使用して、イメージリストのすべてのイメージを削除します。
```
' Removes the first image in the image list
ImageList1.Images.Remove(myImage)
' Clears all images in the image list
ImageList1.Images.Clear()
```

// Removes the first image in the image list.
imageList1.Images.Remove(myImage);
// Clears all images in the image list.
imageList1.Images.Clear();

キーを指定してイメージを削除するには

RemoveByKey メソッドを使用して、キーに対応する単一のイメージを削除します。
```
' Removes the image named "myPhoto" from the list.
ImageList1.Images.RemoveByKey("myPhoto")
```

// Removes the image named "myPhoto" from the list.
imageList1.Images.RemoveByKey("myPhoto");

参照

ImageList コンポーネントの概要 (Windows フォーム)

その他の技術情報

ImageList コンポーネント (Windows フォーム)

イメージ、ビットマップ、およびメタファイル