RadioButton.AutoCheck Eigenschaft

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Ruft einen Wert ab, der angibt, ob beim Klicken auf das Steuerelement der Checked-Wert und die Darstellung des Steuerelements automatisch geändert werden, oder legt diesen fest.

public:
 property bool AutoCheck { bool get(); void set(bool value); };

public bool AutoCheck { get; set; }

member this.AutoCheck : bool with get, set

Public Property AutoCheck As Boolean

Eigenschaftswert

Boolean

true, wenn der Checked-Wert und die Darstellung des Steuerelements beim Click-Ereignis automatisch geändert werden, andernfalls false. Der Standardwert ist true.

Beispiele

Im folgenden Codebeispiel wird eine RadioButtonerstellt und initialisiert, gibt ihr die Darstellung eines Umschaltsteuerelements, legt seine AutoCheck -Eigenschaft auf falsefest und fügt es zu einer Formhinzu.

private void InitializeMyRadioButton()
{
   // Create and initialize a new RadioButton.
   RadioButton radioButton1 = new RadioButton();

   // Make the radio button control appear as a toggle button.
   radioButton1.Appearance = Appearance.Button;

   // Turn off the update of the display on the click of the control.
   radioButton1.AutoCheck = false;

   // Add the radio button to the form.
   Controls.Add(radioButton1);
}

Private Sub InitializeMyRadioButton()
    ' Create and initialize a new RadioButton. 
    Dim radioButton1 As New RadioButton()
       
    ' Make the radio button control appear as a toggle button.
    radioButton1.Appearance = Appearance.Button
       
    ' Turn off the update of the display on the click of the control.
    radioButton1.AutoCheck = False
       
    ' Add the radio button to the form.
    Controls.Add(radioButton1)
End Sub

Hinweise

Wenn der Checked Wert auf falsefestgelegt ist, muss der RadioButton Teil des Steuerelements im Code des Click Ereignishandlers überprüft werden. Wenn außerdem Teil RadioButton einer RadioButton Steuerelementgruppe ist, stellt diese Eigenschaft sicher, dass nur eines der Steuerelemente zu einem bestimmten Zeitpunkt überprüft wird.

Wenn die AutoCheck -Eigenschaft auf falsefestgelegt ist, fungiert eine Gruppe von Steuerelementen RadioButton nicht als sich gegenseitig ausschließende Gruppe, und die Checked Eigenschaft muss im Code aktualisiert werden.