CheckBox.CheckState Vlastnost
Definice
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
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 MiddleRight
System.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 false
hodnotu , 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ý. |