RadioButton.AutoCheck-Eigenschaft

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.

Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)

Syntax

'Declaration
Public Property AutoCheck As Boolean
'Usage
Dim instance As RadioButton
Dim value As Boolean

value = instance.AutoCheck

instance.AutoCheck = value

public bool AutoCheck { get; set; }

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

/** @property */
public boolean get_AutoCheck ()

/** @property */
public void set_AutoCheck (boolean value)

public function get AutoCheck () : boolean

public function set AutoCheck (value : boolean)

Eigenschaftenwert

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

Hinweise

Wenn der Checked-Wert auf false festgelegt ist, muss der RadioButton-Bereich des Steuerelements im Code des Click-Ereignishandlers aktiviert werden. Wenn RadioButton zu einer Gruppe von RadioButton-Steuerelementen gehört, wird dadurch außerdem sichergestellt, dass jeweils nur eines der Steuerelemente aktiviert ist.

Wenn die AutoCheck-Eigenschaft auf false festgelegt ist, verhält sich eine Gruppe von RadioButton-Steuerelementen nicht wie eine Gruppe von sich einander ausschließenden Optionen, und die Aktualisierung der Checked-Eigenschaft muss im Code erfolgen.

Beispiel

Im folgenden Codebeispiel wird ein RadioButton erstellt und initialisiert. Dieser soll als umschaltbares Steuerelement dargestellt werden, die AutoCheck-Eigenschaft wird auf false festgelegt, und das Steuerelement wird in einem Form hinzugefügt.

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

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 void InitializeMyRadioButton()
{
    // Create and initialize a new RadioButton. 
    RadioButton radioButton1 = new RadioButton();

    // Make the radio button control appear as a toggle button.
    radioButton1.set_Appearance(Appearance.Button);

    // Turn off the update of the display on the click of the control.
    radioButton1.set_AutoCheck(false);
    
    // Add the radio button to the form.
    get_Controls().Add(radioButton1);
} //InitializeMyRadioButton

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

RadioButton-Klasse
RadioButton-Member
System.Windows.Forms-Namespace