RadioButton

A RadioButton control shows a standard radio button that users can select. You use a RadioButton control as part of a group of RadioButton controls. Only one RadioButton control in a group can be selected at a time, and when a user selects a new RadioButton in a group, SPEAK automatically clears the previously selected button. You create a group by setting the GroupName property of a set of RadioButton controls to the same value. You must place buttons that are in the same group right after each other. It is technically possible not to do this, but this creates a confusing user experience.

You can set the Text property to create a label for a RadioButton control. You can set the Value property to any string, and use this string in page code or in a rule. The RadioButton control always returns this string as the value of the Value property, even if the button is not selected.

When SPEAK first loads a page with a group of RadioButton controls, and if you have not set the IsChecked property to true for any of the buttons in the group, the user sees a group with no selected buttons. When the user selects one of the buttons, it becomes impossible for the user to go back to the state where no button is selected. You can change this behavior by setting the IsChecked property to true for a button when you design the page.