CheckBox.Checked Vlastnost

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Zdroj:

CheckBox.cs

Získá nebo nastaví hodnotu určující, zda CheckBox je v kontrolovaném stavu.

public:
 property bool Checked { bool get(); void set(bool value); };

[System.ComponentModel.Bindable(true)]
[System.ComponentModel.SettingsBindable(true)]
public bool Checked { get; set; }

[<System.ComponentModel.Bindable(true)>]
[<System.ComponentModel.SettingsBindable(true)>]
member this.Checked : bool with get, set

Public Property Checked As Boolean

Hodnota vlastnosti

Boolean

true CheckBox pokud je v zaškrtnutém stavu; v opačném případě false. Výchozí hodnota je false.

Poznámka: Pokud je vlastnost nastavena na , vrátí se vlastnost true pro hodnotu nebo CheckedCheckStateIndeterminate.CheckedtrueThreeState

Atributy

BindableAttribute SettingsBindableAttribute

Příklady

Následující příklad kódu zobrazí hodnoty tří vlastností v popisku. Vlastnost ThreeState se liší mezi true a false se střídavým kliknutím ovládacího prvku a CheckAlign střídavě mezi ContentAlignment hodnotou MiddleRight a MiddleLeft. Tento příklad ukazuje, jak se hodnoty vlastností mění při ThreeState změně vlastnosti a ovládací prvek je zaškrtnuté. Tento příklad vyžaduje vytvoření CheckBoxLabelButton instance a všechny instance ve formuláři a že popisek je dostatečně velký, aby se zobrazily tři řádky textu a odkaz na System.Drawing obor názvů. Tento kód by měl být volána v Click obslužné rutině události ovládacího prvku.

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

Poznámky

Pokud je truehodnota , CheckBox část ovládacího prvku zobrazí značku zaškrtnutí. Pokud je vlastnost nastavena AppearanceButtonna , ovládací prvek se zobrazí zaspal, když Checked je true a vyvolán jako standardní tlačítko, když false.

Viz také

• ThreeState
• CheckState