[C#][Windows Formsアプリ][CheckedListBox] クリックでチェックを簡単に

[C#][Windows Formsアプリ][CheckedListBox] クリックでチェックを簡単にする方法

CheckedListBox

2025.01.07

はじめに
CheckOnClickプロパティとは？
CheckOnClickプロパティの設定方法
使用例
まとめ

はじめに

この記事では、Windows Formsアプリケーション開発の初心者向けに、CheckedListBoxコントロールのCheckOnClickプロパティについて解説します。CheckOnClickプロパティを使用すると、ユーザーが項目をクリックするだけでチェックボックスの状態を切り替えることができ、操作性が向上します。具体的な設定方法や使用例を通じて、このプロパティの活用法を学びましょう。

CheckOnClickプロパティとは？

CheckOnClickプロパティは、ユーザーがリスト項目をクリックしたときに、その項目のチェックボックスの状態を自動的に切り替えるかどうかを指定するものです。デフォルトではfalseに設定されていますが、これをtrueに設定することで、クリック操作だけでチェックのオン・オフが可能になります。

CheckOnClickプロパティの設定方法

CheckOnClickプロパティを設定するには、以下の手順に従います。

Visual StudioでWindows Formsプロジェクトを作成します。
フォームにCheckedListBoxコントロールを追加します。
コードビハインドでCheckOnClickプロパティをtrueに設定します。

以下は、具体的なコード例です。

public partial class Form1 : Form
{
    public Form1()
    {
        InitializeComponent();
        
        // CheckedListBoxの初期設定
        checkedListBox1.Items.AddRange(new object[] { "Item 1", "Item 2", "Item 3" });
        
        // CheckOnClickプロパティをtrueに設定
        checkedListBox1.CheckOnClick = true;
    }
}

この設定により、ユーザーが項目をクリックするだけでチェックボックスの状態が切り替わるようになります。

使用例

CheckOnClickプロパティを活用することで、ユーザーインターフェースの操作性が向上します。例えば、タスク管理アプリケーションで、ユーザーが完了したタスクを簡単にチェックできるようになります。

private void Form1_Load(object sender, EventArgs e)
{
    // タスクのリストを設定
    checkedListBox1.Items.AddRange(new object[] { "Task 1", "Task 2", "Task 3" });
    
    // CheckOnClickプロパティをtrueに設定
    checkedListBox1.CheckOnClick = true;
}

private void btnShowCheckedItems_Click(object sender, EventArgs e)
{
    // チェックされた項目を表示
    foreach (var item in checkedListBox1.CheckedItems)
    {
        MessageBox.Show(item.ToString());
    }
}