CheckBox.CheckState Свойство

Определение

Получает или задает состояние CheckBox.Gets or sets the state of the CheckBox.

public:
 property System::Windows::Forms::CheckState CheckState { System::Windows::Forms::CheckState get(); void set(System::Windows::Forms::CheckState value); };
[System.ComponentModel.Bindable(true)]
public System.Windows.Forms.CheckState CheckState { get; set; }
member this.CheckState : System.Windows.Forms.CheckState with get, set
Public Property CheckState As CheckState

Значение свойства

Одно из значений перечисления CheckState.One of the CheckState enumeration values. Значение по умолчанию — Unchecked.The default value is Unchecked.

Атрибуты

Исключения

Назначенное значение не является одним из значений перечисления CheckState.The value assigned is not one of the CheckState enumeration values.

Примеры

В следующем примере кода отображаются значения трех свойств в метке.The following code example displays the values of three properties in a label. false MiddleRight CheckAlign System.Drawing.ContentAlignment MiddleLeft Свойство переключается между true и с помощью чередующихся щелчков элемента управления и вариантов между значениями и. ThreeStateThe ThreeState property alternates between true and false with alternating clicks of the control and the CheckAlign alternates between the MiddleRight and MiddleLeft values of System.Drawing.ContentAlignment. В этом примере показано изменение значений свойств при ThreeState изменении свойства и проверка элемента управления.This example shows how the property values change as the ThreeState property changes and the control is checked. CheckBoxВ этом примере требуется Label System.Drawing , чтобы в форме были созданы экземпляры, и все онидостаточновелики,чтобыотображалисьтристрокитекста,атакжессылканапространствоимен.ButtonThis example requires that a CheckBox, Label and Button have all been instantiated on a form and that the label is large enough to display three lines of text, as well as a reference to the System.Drawing namespace. Этот код должен вызываться в Click обработчике событий элемента управления.This code should be called in the Click event handler of the control.

private:
   void AdjustMyCheckBoxProperties()
   {
      // Concatenate the property values together on three lines.
      label1->Text = String::Format( "ThreeState: {0}\nChecked: {1}\nCheckState: {2}",
         checkBox1->ThreeState, checkBox1->Checked, checkBox1->CheckState );
      
      // Change the ThreeState and CheckAlign properties on every other click.
      if ( !checkBox1->ThreeState )
      {
         checkBox1->ThreeState = true;
         checkBox1->CheckAlign = ContentAlignment::MiddleRight;
      }
      else
      {
         checkBox1->ThreeState = false;
         checkBox1->CheckAlign = ContentAlignment::MiddleLeft;
      }
   }
private void AdjustMyCheckBoxProperties()
 {
    // Change the ThreeState and CheckAlign properties on every other click.
    if (!checkBox1.ThreeState)
    {
       checkBox1.ThreeState = true;
       checkBox1.CheckAlign = ContentAlignment.MiddleRight;
    }
    else
    {
       checkBox1.ThreeState = false;
       checkBox1.CheckAlign = ContentAlignment.MiddleLeft;
    }

    // Concatenate the property values together on three lines.
    label1.Text = "ThreeState: " + checkBox1.ThreeState.ToString() + "\n" +
                  "Checked: " + checkBox1.Checked.ToString() + "\n" +
                  "CheckState: " + checkBox1.CheckState.ToString(); 
 }
 
Private Sub AdjustMyCheckBoxProperties()

    ' Change the ThreeState and CheckAlign properties on every other click.
    If Not checkBox1.ThreeState Then
        checkBox1.ThreeState = True
        checkBox1.CheckAlign = ContentAlignment.MiddleRight
    Else
        checkBox1.ThreeState = False
        checkBox1.CheckAlign = ContentAlignment.MiddleLeft
    End If

    ' Concatenate the property values together on three lines.
    label1.Text = "ThreeState: " & checkBox1.ThreeState.ToString() & ControlChars.Cr & _
        "Checked: " & checkBox1.Checked.ToString() & ControlChars.Cr & _
        "CheckState: " & checkBox1.CheckState.ToString()

End Sub

Комментарии

Если свойство имеет falseзначение, CheckState значение свойства может быть задано CheckState.Indeterminate только в коде, а не при взаимодействии с пользователем. ThreeStateIf the ThreeState property is set to false, the CheckState property value can only be set to CheckState.Indeterminate in code and not by user interaction.

В следующей System.Windows.Forms.Appearance таблице описаны CheckBox элементы управления в различных состояниях Normal элемента управления CheckBox.Appearanceстиля и Button .The following table describes the System.Windows.Forms.Appearance of the CheckBox control in its different states for the Normal and Button style control CheckBox.Appearance.

Свойство CheckStateCheckState Внешний вид. ОбычнаяAppearance.Normal Внешний вид. КнопкаAppearance.Button
Checked CheckBox Отображает галочку.The CheckBox displays a check mark. Элемент управления выглядит утопленным.The control appears sunken.
Unchecked Очередь CheckBox является пустой.The CheckBox is empty. Элемент управления отображается как вызванный.The control appears raised.
Indeterminate Элемент CheckBox отображает галочку и затенен.The CheckBox displays a check mark and is shaded. Элемент управления выглядит плоским.The control appears flat.

Применяется к

Дополнительно