NGWS SDK Documentation  

This is preliminary documentation and subject to change.
To comment on this topic, please send us email at ngwssdk@microsoft.com. Thanks!

RadioButton Control

Win Forms RadioButton controls present a set of two or more mutually exclusive choices to the user. While radio buttons and check boxes may appear to function similarly, there is an important difference: when a user selects a radio button, the other radio buttons in the same group cannot be selected as well. In contrast, any number of check boxes can be selected. Defining a radio button group tells the user, “Here is a set of choices from which you can choose one and only one.”

When a RadioButton control is clicked, its Checked property is set to true and the Click event-handling method is called. If the AutoCheck property is set to true (the default), when the radio button is clicked all others in the group are automatically deselected. This property is usually only set to false when validation code is used to make sure the radio button selected is an allowable option. The text displayed within the control is set with the Text property, which can contain access key shortcuts. For more information, see Creating Keyboard Shortcuts for Controls and Setting the Text Displayed by a Control.

The RadioButton control can appear like a toggle button if the Appearance property is set to Appearance.Button. Radio buttons can also display images using the Image and ImageList properties. For more information, see Setting the Image Displayed by a Control.

See Also

Panel Control | GroupBox Control | CheckBox Control | Creating Keyboard Shortcuts for Controls | Setting the Text Displayed by a Control | Grouping RadioButton Controls to Function As a Set