Radio Button (MSAA UI Element Reference)
Note
This topic describes Radio Button objects for purposes of MSAA UI Element Reference. How to create Radio Button objects in various UI frameworks is not described here. See the API reference documentation for the UI framework you're using.
Radio buttons are used to select one of several options, usually within a dialog box. A radio button contains a small circle with text next to it. When selected, the circle has a smaller, filled circle inside it. Selecting one button in a set deselects the previously selected button, so only one of the options in the set is selected at a time.
The window class name for a radio button is "BUTTON".
IAccessible Methods
A radio button supports the following IAccessible methods:
| Method | Comments |
|---|---|
| accDoDefaultAction | The accDoDefaultAction method clicks the radio button. |
| accHitTest | |
| accLocation | |
| accNavigate | |
| accSelect |
IAccessible Properties
A radio button supports the following IAccessible properties:
| Property | Comments |
|---|---|
| get_accChild | |
| get_accChildCount | The ChildCount property is zero. |
| get_accDefaultAction | The DefaultAction property for a radio button is "Check". |
| get_accDescription | |
| get_accFocus | |
| get_accHelp | |
| get_accHelpTopic | |
| get_accKeyboardShortcut | The KeyboardShortcut property is the radio button's access key, which is an underlined character in the control's window text. This string contains the access key character appended to the string "Alt+". |
| get_accName | The Name property is obtained from the control's window text (or caption), which is displayed with the radio button. |
| get_accParent | The Parent property is a window ( ROLE_SYSTEM_WINDOW ) that surrounds the control and has the same Name property and window class name as the control. |
| get_accRole | The Role property is ROLE_SYSTEM_RADIOBUTTON. |
| get_accState | The State property is a combination of one or more of the following values: STATE_SYSTEM_INVISIBLE | STATE_SYSTEM_UNAVAILABLE | STATE_SYSTEM_FOCUSED | STATE_SYSTEM_FOCUSABLE | STATE_SYSTEM_CHECKED | STATE_SYSTEM_NORMAL |