CheckedListBox.CheckOnClick プロパティ

項目が選択されたときに、チェック ボックスを切り替えるかどうかを示す値を取得または設定します。

Public Property CheckOnClick As Boolean
[C#]
public bool CheckOnClick {get; set;}
[C++]
public: __property bool get_CheckOnClick();public: __property void set_CheckOnClick(bool);
[JScript]
public function get CheckOnClick() : Boolean;public function set CheckOnClick(Boolean);

プロパティ値

すぐにチェック マークが適用される場合は true 。それ以外の場合は false 。既定値は false です。

解説

CheckOnClick は、項目が選択されたときに、必ずチェック ボックスを切り替えるかどうかを示します。既定の動作では、クリックして選択項目を変更し、さらにもう一度クリックしてチェック マークを適用します。ただし、クリックと同時に項目もチェックされる方が良い場合もあります。

使用例

[Visual Basic, C#] CheckOnClick プロパティ、 SelectionMode プロパティ、および CheckedListBox. System.Windows.Forms.CheckedListBox.3DCheckBoxes プロパティを設定して CheckedListBox コントロールを初期化するコード例を次に示します。このコードは、CheckedListBox にコントロールを読み込み、CheckedListBox. System.Windows.Forms.CheckedListBox.Display メンバにコントロールの名前プロパティを設定します。この例を実行するには、CheckedListBox1 という名前の CheckedListBox オブジェクトが配置されているフォームに次のコードを貼り付けて、フォームのコンストラクタまたは Load メソッドから InitializeCheckListBox メソッドを呼び出します。

 
' This method initializes CheckedListBox1 with a list of all the controls
' on the form. It sets the selection mode to single selection and
' allows selection with a single click. It adds itself to the list before 
' adding itself to the form.
Friend WithEvents CheckedListBox1 As System.Windows.Forms.CheckedListBox

Private Sub InitializeCheckedListBox()
    Me.CheckedListBox1 = New CheckedListBox
    Me.CheckedListBox1.Location = New System.Drawing.Point(40, 90)
    Me.CheckedListBox1.CheckOnClick = True
    Me.CheckedListBox1.Name = "CheckedListBox1"
    Me.CheckedListBox1.Size = New System.Drawing.Size(120, 94)
    Me.CheckedListBox1.TabIndex = 1
    Me.CheckedListBox1.SelectionMode = SelectionMode.One
    Me.CheckedListBox1.ThreeDCheckBoxes = True

    Dim aControl As Control
    For Each aControl In Me.Controls
        Me.CheckedListBox1.Items.Add(aControl, False)
    Next

    Me.CheckedListBox1.DisplayMember = "Name"
    Me.CheckedListBox1.Items.Add(CheckedListBox1)
    Me.Controls.Add(Me.CheckedListBox1)
End Sub

[C#] 
// This method initializes CheckedListBox1 with a list of all 
// the controls on the form. It sets the selection mode
// to single selection and allows selection with a single click.
// It adds itself to the list before adding itself to the form.

internal System.Windows.Forms.CheckedListBox CheckedListBox1;

private void InitializeCheckedListBox()
{
    this.CheckedListBox1 = new CheckedListBox();
    this.CheckedListBox1.Location = new System.Drawing.Point(40, 90);
    this.CheckedListBox1.CheckOnClick = true;
    this.CheckedListBox1.Name = "CheckedListBox1";
    this.CheckedListBox1.Size = new System.Drawing.Size(120, 94);
    this.CheckedListBox1.TabIndex = 1;
    this.CheckedListBox1.SelectionMode = SelectionMode.One;
    this.CheckedListBox1.ThreeDCheckBoxes = true;

    foreach ( Control aControl in this.Controls )
    {
        this.CheckedListBox1.Items.Add(aControl, false);
    }

    this.CheckedListBox1.DisplayMember = "Name";
    this.CheckedListBox1.Items.Add(CheckedListBox1);
    this.Controls.Add(this.CheckedListBox1);
}

[C++, JScript] C++ および JScript のサンプルはありません。Visual Basic および C# のサンプルを表示するには、このページの左上隅にある言語のフィルタ ボタン をクリックします。

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ

参照

CheckedListBox クラス | CheckedListBox メンバ | System.Windows.Forms 名前空間