CheckBox.Checked Свойство

Определение

Получает или задает значение, определяющее, находится ли CheckBox в выбранном состоянии.Gets or set a value indicating whether the CheckBox is in the checked state.

public:
 property bool Checked { bool get(); void set(bool value); };
[System.ComponentModel.Bindable(true)]
[System.ComponentModel.SettingsBindable(true)]
public bool Checked { get; set; }
member this.Checked : bool with get, set
Public Property Checked As Boolean

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

Значение true, если элемент управления CheckBox находится во включенном состоянии; в противном случае — false.true if the CheckBox is in the checked state; otherwise, false. Значение по умолчанию — false.The default value is false.


Если для свойства ThreeState установлено значение true, свойство Checked будет возвращать значение true для Checked или IndeterminateCheckState.If the ThreeState property is set to true, the Checked property will return true for either a Checked or IndeterminateCheckState.

Атрибуты

Примеры

В следующем примере кода отображаются значения трех свойств в метке.The following code example displays the values of three properties in a label. Свойство ThreeState переключается между true и false с помощью чередующихся щелчков элемента управления, а CheckAlign альтернативы ContentAlignment значению MiddleRight и MiddleLeft.The ThreeState property alternates between true and false with alternating clicks of the control and the CheckAlign alternates between a ContentAlignment value of MiddleRight and MiddleLeft. В этом примере показано, как изменяются значения свойств при изменении свойства ThreeState и проверки элемента управления.This example shows how the property values change as the ThreeState property changes and the control is checked. В этом примере требуется, чтобы в форме был создан экземпляр CheckBox, Label и Button, и что метка достаточно велика, чтобы отображались три строки текста, а также ссылка на пространство имен System.Drawing.This 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

Комментарии

Если значение равно true, CheckBox часть элемента управления отображает галочку.When the value is true, the CheckBox portion of the control displays a check mark. Если свойство Appearance имеет значение Button, элемент управления будет отображаться утопленным, когда Checked true и будет вызываться как стандартная кнопка при false.If the Appearance property is set to Button, the control will appear sunken when Checked is true and raised like a standard button when false.

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

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