CheckBox.CheckState Vlastnost

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Zdroj:

CheckBox.cs

Získá nebo nastaví stav 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 ThreeState se liší mezi true a false se střídavým kliknutím ovládacího prvku a CheckAlign střídavými střídavými hodnotami MiddleRightMiddleLeftSystem.Drawing.ContentAlignment. 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 vlastnost nastavena ThreeState na false, CheckState hodnota vlastnosti může být nastavena CheckState.Indeterminate pouze v kódu, a ne interakcí uživatele.

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

Checkstate	Vzhled.Normální	Appearance.Button
Checked	Zobrazí CheckBox značku zaškrtnutí.	Ovládací prvek se zobrazí se sunken.
Unchecked	Je CheckBox prázdný.	Ovládací prvek se zobrazí vyvolaný.
Indeterminate	Zobrazí CheckBox značku zaškrtnutí a je vystínována.	Ovládací prvek je plochý.

Viz také

• Checked
• ThreeState