Sdílet prostřednictvím


CheckBox.CheckState Vlastnost

Definice

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

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

Atributy

Výjimky

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.AppearanceCheckBox 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

Viz také