Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
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.

[Visual Basic]
Public Property AutoCheck As Boolean
[C#]
public bool AutoCheck {get; set;}
[C++]
public: __property bool get_AutoCheck();
public: __property void set_AutoCheck(bool);
[JScript]
public function get AutoCheck() : Boolean;
public function set AutoCheck(Boolean);

Property Value

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

Remarks

If the Checked value is set to false, the radio button 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.

Example

[Visual Basic, C#, C++] The following example creates and initializes a RadioButton, gives it the appearance of a toggle button, sets its AutoCheck property to false, and adds it to a Form.

[Visual Basic] 
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


[C#] 
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);
}


[C++] 
private:
    void InitializeMyRadioButton() {
        // Create and initialize a new RadioButton. 
        RadioButton __gc *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);
    };

[JScript] No example is available for JScript. To view a Visual Basic, C#, or C++ example, click the Language Filter button Language Filter in the upper-left corner of the page.

Requirements

Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family

See Also

RadioButton Class | RadioButton Members | System.Windows.Forms Namespace

Show:
© 2015 Microsoft