Edit

Radio Button (MSAA UI Element Reference)

  • Article

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

IAccessible Interface

Check Box

Group Box

Push Button