Edit

Group Box (MSAA UI Element Reference)

  • Article

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

IAccessible Interface