ImageList

[C#] ImageListへの画像追加方法

2025-04-15更新日: 2025-04-15

C#でImageListに画像を追加する方法は、まずImageListオブジェクトを作成し、その後に画像を追加します。

ImageListは、System.Windows.Forms名前空間に含まれており、主にWindowsフォームアプリケーションで使用されます。

画像を追加するには、ImageList.Images.Addメソッドを使用します。

このメソッドは、Imageオブジェクトを引数として受け取ります。

例えば、ImageListにビットマップ画像を追加する場合、Bitmapクラスを使用して画像を読み込み、それをAddメソッドに渡します。

追加された画像は、ImageListのインデックスを使用してアクセスできます。

目次から探す
  1. 画像の追加方法
  2. ImageListの画像管理
  3. ImageListの応用例
  4. まとめ

画像の追加方法

画像の読み込み

Bitmapクラスを使用した画像読み込み

C#では、Bitmapクラスを使用して画像を読み込むことができます。

以下のサンプルコードでは、Bitmapクラスを使って画像ファイルを読み込み、ImageListに追加する方法を示します。

using System.Drawing;
using System.Windows.Forms;
public partial class MyForm : Form
{
    private ImageList imageList;
    public MyForm()
    {
        InitializeComponent();
        imageList = new ImageList();
        // Bitmapクラスを使用して画像を読み込む
        Bitmap bitmap = new Bitmap("path_to_image.jpg");
        imageList.Images.Add(bitmap);
    }
}

このコードでは、指定したパスの画像をBitmapクラスで読み込み、ImageListに追加しています。

Image.FromFileメソッドを使用した画像読み込み

Image.FromFileメソッドを使用することで、画像ファイルを簡単に読み込むことができます。

以下のサンプルコードでは、このメソッドを使って画像を読み込み、ImageListに追加する方法を示します。

using System.Drawing;
using System.Windows.Forms;
public partial class MyForm : Form
{
    private ImageList imageList;
    public MyForm()
    {
        InitializeComponent();
        imageList = new ImageList();
        // Image.FromFileメソッドを使用して画像を読み込む
        Image image = Image.FromFile("path_to_image.jpg");
        imageList.Images.Add(image);
    }
}

このコードでは、Image.FromFileメソッドを使用して画像を読み込み、ImageListに追加しています。

ImageListへの画像追加

Images.Addメソッドの使用

ImageListに画像を追加する最も基本的な方法は、Images.Addメソッドを使用することです。

以下のサンプルコードでは、Images.Addメソッドを使って画像を追加する方法を示します。

using System.Drawing;
using System.Windows.Forms;
public partial class MyForm : Form
{
    private ImageList imageList;
    public MyForm()
    {
        InitializeComponent();
        imageList = new ImageList();
        // 画像を追加する
        imageList.Images.Add("imageKey", Image.FromFile("path_to_image.jpg"));
    }
}

このコードでは、Images.Addメソッドを使用して、画像をImageListに追加しています。

キーを指定することで、後で画像を簡単に取得できます。

Images.AddRangeメソッドの使用

複数の画像を一度に追加したい場合は、Images.AddRangeメソッドを使用します。

以下のサンプルコードでは、配列を使って複数の画像を追加する方法を示します。

using System.Drawing;
using System.Windows.Forms;
public partial class MyForm : Form
{
    private ImageList imageList;
    public MyForm()
    {
        InitializeComponent();
        imageList = new ImageList();
        // 複数の画像を追加する
        Image[] images = new Image[]
        {
            Image.FromFile("path_to_image1.jpg"),
            Image.FromFile("path_to_image2.jpg"),
            Image.FromFile("path_to_image3.jpg")
        };
        imageList.Images.AddRange(images);
    }
}

このコードでは、Images.AddRangeメソッドを使用して、配列に格納された複数の画像をImageListに追加しています。

ImageListの画像管理

画像の削除

Removeメソッドの使用

ImageListから特定の画像を削除するには、Removeメソッドを使用します。

このメソッドは、指定した画像をImageListから削除します。

以下のサンプルコードでは、Removeメソッドを使って画像を削除する方法を示します。

using System.Drawing;
using System.Windows.Forms;
public partial class MyForm : Form
{
    private ImageList imageList;
    public MyForm()
    {
        InitializeComponent();
        imageList = new ImageList();
        // 画像を追加する
        imageList.Images.Add("imageKey", Image.FromFile("path_to_image.jpg"));
        // 画像を削除する
        imageList.Images.RemoveByKey("imageKey");
    }
}

このコードでは、RemoveByKeyメソッドを使用して、指定したキーの画像をImageListから削除しています。

Clearメソッドの使用

ImageList内のすべての画像を削除したい場合は、Clearメソッドを使用します。

以下のサンプルコードでは、Clearメソッドを使ってすべての画像を削除する方法を示します。

using System.Drawing;
using System.Windows.Forms;
public partial class MyForm : Form
{
    private ImageList imageList;
    public MyForm()
    {
        InitializeComponent();
        imageList = new ImageList();
        // 画像を追加する
        imageList.Images.Add("imageKey1", Image.FromFile("path_to_image1.jpg"));
        imageList.Images.Add("imageKey2", Image.FromFile("path_to_image2.jpg"));
        // すべての画像を削除する
        imageList.Images.Clear();
    }
}

このコードでは、Clearメソッドを使用して、ImageList内のすべての画像を削除しています。

画像の取得

インデックスを使用した画像取得

ImageListから画像を取得する最も基本的な方法は、インデックスを使用することです。

以下のサンプルコードでは、インデックスを使って画像を取得する方法を示します。

using System.Drawing;
using System.Windows.Forms;
public partial class MyForm : Form
{
    private ImageList imageList;
    public MyForm()
    {
        InitializeComponent();
        imageList = new ImageList();
        // 画像を追加する
        imageList.Images.Add(Image.FromFile("path_to_image1.jpg"));
        imageList.Images.Add(Image.FromFile("path_to_image2.jpg"));
        // インデックスを使用して画像を取得する
        Image firstImage = imageList.Images[0];
    }
}

このコードでは、インデックス0を使用して、ImageListから最初の画像を取得しています。

キーを使用した画像取得

ImageListに追加した画像には、キーを設定することができます。

キーを使用して画像を取得することも可能です。

以下のサンプルコードでは、キーを使って画像を取得する方法を示します。

using System.Drawing;
using System.Windows.Forms;
public partial class MyForm : Form
{
    private ImageList imageList;
    public MyForm()
    {
        InitializeComponent();
        imageList = new ImageList();
        // 画像を追加する
        imageList.Images.Add("imageKey1", Image.FromFile("path_to_image1.jpg"));
        imageList.Images.Add("imageKey2", Image.FromFile("path_to_image2.jpg"));
        // キーを使用して画像を取得する
        Image secondImage = imageList.Images["imageKey2"];
    }
}

このコードでは、キー"imageKey2"を使用して、ImageListから特定の画像を取得しています。

ImageListの応用例

ListViewでのImageListの使用

ListViewコントロールは、アイコンや画像を表示するためにImageListを使用することができます。

以下のサンプルコードでは、ListViewにImageListを設定し、画像を表示する方法を示します。

using System.Drawing;
using System.Windows.Forms;
public partial class MyForm : Form
{
    private ImageList imageList;
    private ListView listView;
    public MyForm()
    {
        InitializeComponent();
        imageList = new ImageList();
        listView = new ListView();
        // 画像を追加する
        imageList.Images.Add("imageKey1", Image.FromFile("path_to_image1.jpg"));
        imageList.Images.Add("imageKey2", Image.FromFile("path_to_image2.jpg"));
        // ListViewにImageListを設定する
        listView.LargeImageList = imageList;
        // ListViewにアイテムを追加する
        listView.Items.Add(new ListViewItem("Item 1", "imageKey1"));
        listView.Items.Add(new ListViewItem("Item 2", "imageKey2"));
        // ListViewをフォームに追加する
        Controls.Add(listView);
    }
}

このコードでは、ListViewにImageListを設定し、各アイテムに画像を関連付けています。

TreeViewでのImageListの使用

TreeViewコントロールでも、ImageListを使用してノードにアイコンを表示することができます。

以下のサンプルコードでは、TreeViewにImageListを設定し、ノードに画像を表示する方法を示します。

using System.Drawing;
using System.Windows.Forms;
public partial class MyForm : Form
{
    private ImageList imageList;
    private TreeView treeView;
    public MyForm()
    {
        InitializeComponent();
        imageList = new ImageList();
        treeView = new TreeView();
        // 画像を追加する
        imageList.Images.Add("folderIcon", Image.FromFile("path_to_folder_icon.png"));
        imageList.Images.Add("fileIcon", Image.FromFile("path_to_file_icon.png"));
        // TreeViewにImageListを設定する
        treeView.ImageList = imageList;
        // TreeViewにノードを追加する
        TreeNode folderNode = new TreeNode("フォルダ", 0, 0);
        TreeNode fileNode = new TreeNode("ファイル", 1, 1);
        folderNode.Nodes.Add(fileNode);
        treeView.Nodes.Add(folderNode);
        // TreeViewをフォームに追加する
        Controls.Add(treeView);
    }
}

このコードでは、TreeViewにImageListを設定し、ノードにアイコンを表示しています。

ToolStripでのImageListの使用

ToolStripコントロールでは、ImageListを使用してツールボタンにアイコンを表示することができます。

以下のサンプルコードでは、ToolStripにImageListを設定し、ボタンに画像を表示する方法を示します。

using System.Drawing;
using System.Windows.Forms;
public partial class MyForm : Form
{
    private ImageList imageList;
    private ToolStrip toolStrip;
    public MyForm()
    {
        InitializeComponent();
        imageList = new ImageList();
        toolStrip = new ToolStrip();
        // 画像を追加する
        imageList.Images.Add("newIcon", Image.FromFile("path_to_new_icon.png"));
        imageList.Images.Add("openIcon", Image.FromFile("path_to_open_icon.png"));
        // ToolStripにImageListを設定する
        toolStrip.ImageList = imageList;
        // ToolStripにボタンを追加する
        toolStrip.Items.Add(new ToolStripButton("新規", imageList.Images["newIcon"]));
        toolStrip.Items.Add(new ToolStripButton("開く", imageList.Images["openIcon"]));
        // ToolStripをフォームに追加する
        Controls.Add(toolStrip);
    }
}

このコードでは、ToolStripにImageListを設定し、各ボタンにアイコンを表示しています。

まとめ

この記事では、C#のImageListを使用して画像を追加、管理、表示する方法について詳しく解説しました。

具体的には、画像の読み込み方法やImageListへの画像追加、削除、取得の手法、さらにはListView、TreeView、ToolStripでの応用例を紹介しました。

これらの知識を活用することで、より魅力的なユーザーインターフェースを作成することが可能になりますので、ぜひ実際のプロジェクトで試してみてください。

2025-04-15更新日: 2025-04-15
Back to top button