Практическое руководство. Обработка события щелчка элемента управления CheckBox в Windows Forms

Обновлен: Ноябрь 2007

Если щелкнуть элемент управления Windows Forms 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 автоматически меняет состояние при щелчке. В противном случае необходимо вручную задать свойство Checked при возникновении события Click.

  Элемент управления CheckBox используется также для определения образа действия.

Чтобы определить образ действия при щелчке флажка

• Используйте оператор case для запроса значения свойства CheckState, чтобы определить образ действия. Если для свойства ThreeState задано значение true, свойство CheckState возвращает одно из трех возможных значений, соответствующих установленному флажку, снятому флажку или неопределенному состоянию флажка, при котором поле флажка отображается затененным, что означает недоступность параметра.

  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 возвращает true как для Checked, так и для Indeterminate.

См. также

Задачи

Практическое руководство. Задание параметров с помощью элементов управления CheckBox в Windows Forms

Ссылки

Общие сведения об элементе управления CheckBox (Windows Forms)

CheckBox

Другие ресурсы

Элемент управления CheckBox (Windows Forms)