方法 : Windows フォーム CheckBox のクリックに応答する

更新 : 2007 年 11 月

ユーザーが Windows フォームの CheckBox コントロールをクリックすると、Click イベントが発生します。チェック ボックスの状態に応じてアクションを実行するように、アプリケーションをプログラミングできます。

CheckBox のクリックに応答するには

• Click イベント ハンドラ内で Checked プロパティを使用してコントロールの状態を判断し、必要なアクションを実行します。

  Private Sub CheckBox1_Click(ByVal sender As Object, ByVal e As System.EventArgs) Handles CheckBox1.Click
     ' The CheckBox control's Text property is changed each time the 
     ' control is clicked, indicating a checked or unchecked state.
     If CheckBox1.Checked = True Then
        CheckBox1.Text = "Checked"
     Else
        CheckBox1.Text = "Unchecked"
     End If
  End Sub
  

  private void checkBox1_Click(object sender, System.EventArgs e)
  {
     // The CheckBox control's Text property is changed each time the 
     // control is clicked, indicating a checked or unchecked state.
     if (checkBox1.Checked)
     {
        checkBox1.Text = "Checked";
     }
     else
     {
        checkBox1.Text = "Unchecked";
     }
  }
  

  private:
     void checkBox1_CheckedChanged(System::Object ^ sender,
        System::EventArgs ^ e)
     {
        if (checkBox1->Checked)
        {
           checkBox1->Text = "Checked";
        }
        else
        {
           checkBox1->Text = "Unchecked";
        }
     }
  

  メモ :
  ユーザーが CheckBox コントロールをダブルクリックした場合、CheckBox コントロールではダブルクリック イベントがサポートされていないため、それぞれのクリックが個別に処理されます。

  メモ :
  AutoCheck プロパティが true (既定) に設定されている場合、CheckBox をクリックすると、自動的にオンまたはオフになります。それ以外の場合は、Click イベントの発生時に手動で Checked プロパティを設定する必要があります。

  また、CheckBox コントロールを使用して、アクションの実行方法を決めることもできます。

チェック ボックスがクリックされた状態に応じて、アクションの実行方法を決定するには

• case ステートメントを使用して CheckState プロパティの値を問い合わせ、アクションの実行方法を決定します。ThreeState プロパティが true に設定されている場合、CheckState プロパティは、ボックスがオンの状態、ボックスがオフの状態、および中間状態を表す 3 つの値のいずれかを返します。中間状態では、ボックスが淡色表示されてオプションが無効であることが示されます。

  Private Sub CheckBox1_Click(ByVal sender As Object, ByVal e As System.EventArgs) Handles CheckBox1.Click
     Select Case CheckBox1.CheckState
        Case CheckState.Checked
           ' Code for checked state.
        Case CheckState.Unchecked
           ' Code for unchecked state.
        Case CheckState.Indeterminate
           ' Code for indeterminate state.
     End Select 
  End Sub
  

  private void checkBox1_Click(object sender, System.EventArgs e)
  {
     switch(checkBox1.CheckState)
     {
        case CheckState.Checked:
           // Code for checked state.
           break;
        case CheckState.Unchecked:
           // Code for unchecked state.
           break;
        case CheckState.Indeterminate:
           // Code for indeterminate state.
           break;
     }
  }
  

  private:
     void checkBox1_CheckedChanged(System::Object ^ sender,
        System::EventArgs ^ e)
     {
        switch(checkBox1->CheckState) {
           case CheckState::Checked:
              // Code for checked state.
              break;
           case CheckState::Unchecked:
              // Code for unchecked state.
              break;
           case CheckState::Indeterminate:
              // Code for indeterminate state.
              break;
        }
     }
  

  メモ :
  ThreeState プロパティに true が設定されている場合、Checked プロパティは Checked と Indeterminate の両方に対して true を返します。

参照

処理手順

方法 : Windows フォームの CheckBox コントロールでオプションを設定する

参照

CheckBox コントロールの概要 (Windows フォーム)

CheckBox

その他の技術情報

CheckBox コントロール (Windows フォーム)