CheckBox.CheckState Vlastnost

Reference

Definice

Obor názvů:: System.Windows.Forms

Sestavení:: System.Windows.Forms.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Získá nebo nastaví stav objektu 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; }

[<System.ComponentModel.Bindable(true)>]
member this.CheckState : System.Windows.Forms.CheckState with get, set

Public Property CheckState As CheckState

Hodnota vlastnosti

CheckState

Jedna z hodnot výčtu CheckState . Výchozí hodnota je Unchecked.

Atributy: BindableAttribute

Výjimky

InvalidEnumArgumentException

Přiřazená hodnota není jednou z hodnot výčtu CheckState .

Příklady

Následující příklad kódu zobrazí hodnoty tří vlastností v popisku. Vlastnost se ThreeState střídá mezi true a false pomocí střídavých kliknutí na ovládací prvek a CheckAlign střídá hodnoty MiddleRightSystem.Drawing.ContentAlignmenta MiddleLeft . Tento příklad ukazuje, jak se mění hodnoty vlastností při změně ThreeState vlastnosti a kontrole ovládacího prvku. Tento příklad vyžaduje, aby CheckBoxve formuláři byly všechny instance , Label a Button a aby popisek byl dostatečně velký, aby se zobrazily tři řádky textu a odkaz na System.Drawing obor názvů. Tento kód by se měl volat v obslužné Click 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 vlastnost nastavená ThreeState na falsehodnotu , CheckState lze hodnotu vlastnosti nastavit CheckState.Indeterminate pouze v kódu, nikoli interakcí uživatele.

Následující tabulka popisuje System.Windows.Forms.Appearance CheckBox ovládací prvek v různých stavech pro Normal ovládací prvek CheckBox.Appearancea Button styl .

Checkstate	Vzhled.Normální	Appearance.Button
`Checked`	Zobrazí CheckBox se značka zaškrtnutí.	Ovládací prvek se zobrazí potopeně.
`Unchecked`	Hodnota CheckBox je prázdná.	Ovládací prvek se zobrazí jako vyvolaný.
`Indeterminate`	Zobrazí CheckBox se značka zaškrtnutí a je vystínovaná.	Ovládací prvek se zdá být plochý.

Platí pro