Export (0) Print
Expand All

RadioButton.AutoCheck Property

Gets or sets a value indicating whether the Checked value and the appearance of the control automatically change when the control is clicked.

Namespace:  System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)

public bool AutoCheck { get; set; }

Property Value

Type: System.Boolean
true if the Checked value and the appearance of the control automatically change on the Click event; otherwise, false. The default value is true.

If the Checked value is set to false, the RadioButton portion of the control must be checked in code in the Click event handler. In addition, if the RadioButton is part of a RadioButton control group, this property ensures that only one of the controls is checked at a given time.

If the AutoCheck property is set to false, a group of RadioButton controls will not act as a mutually exclusive group and the Checked property must be updated in code.

The following code example creates and initializes a RadioButton, gives it the appearance of a toggle control, sets its AutoCheck property to false, and adds it to a Form.

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.

.NET Framework

Supported in: 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

© 2014 Microsoft