CheckBox.CheckState Eigenschap

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

Waarde van eigenschap

Een van de CheckState opsommingswaarden. De standaardwaarde is Unchecked.

Kenmerken

BindableAttribute

Uitzonderingen

Voorbeelden

In het volgende codevoorbeeld worden de waarden van drie eigenschappen in een label weergegeven. De ThreeState eigenschap wisselt tussen true en false met afwisselende klikken van het besturingselement en de CheckAlign alternatieven tussen de MiddleRight en MiddleLeft waarden van System.Drawing.ContentAlignment. In dit voorbeeld ziet u hoe de eigenschapswaarden veranderen wanneer de ThreeState eigenschap verandert en het besturingselement wordt gecontroleerd. In dit voorbeeld is vereist dat een CheckBox, Label en Button allemaal zijn geïnstantieerd op een formulier en dat het label groot genoeg is om drie regels tekst weer te geven, evenals een verwijzing naar de System.Drawing naamruimte. Deze code moet worden aangeroepen in de Click gebeurtenis-handler van het besturingselement.

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

Opmerkingen

Als de ThreeState eigenschap is ingesteld op false, kan de CheckState eigenschapswaarde alleen worden ingesteld CheckState.Indeterminate op in code en niet op basis van gebruikersinteractie.

In de volgende tabel worden de System.Windows.Forms.Appearance van het besturingselement CheckBox in verschillende toestanden beschreven voor het besturingselement Normal en Button stijl CheckBox.Appearance.

Zie ook

• Checked
• ThreeState