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

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

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

  1. 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 コントロールを使用して、一連のアクションを決定することもできます。

チェック ボックスがクリックされたときの一連の動作を決定するには

  1. 一連のアクションを決定するために、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 プロパティによって、CheckedIndeterminate の両方に対して true が返されます。

関連項目