Group Box (MSAA UI Element Reference)
Note
This topic describes Group Box objects for purposes of MSAA UI Element Reference. How to create Group Box objects in various UI frameworks is not described here. See the API reference documentation for the UI framework you're using.
A group box is a rectangle that surrounds a set of controls, such as check boxes or radio buttons, and contains an application-defined text (label).
The sole purpose of a group box is to organize controls related by a common purpose, indicated by the label.
The window class name for a group box is "BUTTON".
IAccessible Methods
A group box supports the following IAccessible methods:
IAccessible Properties
A group box supports the following IAccessible properties:
| Property | Comments |
|---|---|
| get_accChildCount | The ChildCount property is always zero. |
| get_accFocus | |
| get_accKeyboardShortcut | Group boxes do not have keyboard shortcuts. However, if the window text for the group box contains an ampersand (&) character, Microsoft Active Accessibility returns a non-Null string as the KeyboardShortcut property. |
| get_accName | The Name property is obtained from the control's window text (or caption), which is displayed with the group box. |
| 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_GROUPING. |
| 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 |