MSAA Object Types by Accessibility Roles

Applies to TestComplete 15.47, last modified on January 20, 2023
Information in this topic applies to desktop applications only.

To name the application’s objects that are exposed by the MSAA engine, TestComplete uses object types and indexes (see Addressing Objects in MSAA Open Applications). The type names reflect the accessibility roles of the objects and simplify the script code. This topic lists existing accessibility roles and the corresponding object types used by the MSAA engine. For a list of object types sorted by names, see MSAA Object Types by Names.

ROLE_SYSTEM_ALERT

This role is used by objects that correspond to alerts. TestComplete addresses such objects using the Alert type name.

ROLE_SYSTEM_ANIMATION

This role is used by animation controls. TestComplete addresses such controls using the Animation type name.

ROLE_SYSTEM_APPLICATION

This role is used by an application’s main window. TestComplete addresses such windows using the Application type name.

ROLE_SYSTEM_BORDER

This role is used by window borders. TestComplete addresses such objects using the Border type name.

ROLE_SYSTEM_BUTTONDROPDOWN

This role is used by buttons that drop down a list of items. TestComplete addresses such buttons using the DropDownButton type name.

ROLE_SYSTEM_BUTTONDROPDOWNGRID

This role is used by buttons that drop down a grid. TestComplete addresses such buttons using the GridDropDownButton type name.

ROLE_SYSTEM_BUTTONMENU

This role is used by buttons that drop down a menu. TestComplete addresses such buttons using the MenuButton type name.

ROLE_SYSTEM_CARET

This role is used by the object that represents the system caret. TestComplete addresses such object using the Caret type name.

ROLE_SYSTEM_CELL

This role is used by table cells. TestComplete addresses such objects using the Cell type name.

ROLE_SYSTEM_CHARACTER

This role is used by cartoon-like graphic objects, such as the Microsoft Office Assistant. TestComplete addresses such objects using the Character type name.

ROLE_SYSTEM_CHART

This role is used by charts. TestComplete addresses such objects using the Chart type name.

ROLE_SYSTEM_CHECKBUTTON

This role is used by check box controls. TestComplete addresses such controls using the CheckBox type name.

ROLE_SYSTEM_CLIENT

This role is used by a window’s client area. TestComplete addresses such objects using the Client type name.

ROLE_SYSTEM_CLOCK

This role is used by controls that display time. TestComplete addresses such controls using the Clock type name.

ROLE_SYSTEM_COLUMN

This role is used by columns within a table. TestComplete addresses such objects using the Column type name.

ROLE_SYSTEM_COLUMNHEADER

This role is used by column headers. TestComplete addresses such objects using the ColumnHeader type name.

ROLE_SYSTEM_COMBOBOX

This role is used by combo box controls. TestComplete addresses such controls using the ComboBox type name.

ROLE_SYSTEM_CURSOR

This role is used by the system mouse pointer. TestComplete addresses such object using the Cursor type name.

ROLE_SYSTEM_DIAGRAM

This role is used by diagrams. TestComplete addresses such objects using the Diagram type name.

ROLE_SYSTEM_DIAL

This role is used by dials and knobs. TestComplete addresses such objects using the Dial type name.

ROLE_SYSTEM_DIALOG

This role is used by dialog boxes and message boxes. TestComplete addresses such objects using the Dialog type name.

ROLE_SYSTEM_DOCUMENT

This role is used by document windows in MDI applications. TestComplete addresses such windows using the Document type name.

ROLE_SYSTEM_DROPLIST

This role is used by calendar and drop-down controls. TestComplete addresses such controls using the DropDown type name.

ROLE_SYSTEM_EQUATION

This role is used by objects that correspond to mathematical equations. TestComplete addresses such objects using the Equation type name.

ROLE_SYSTEM_GRAPHIC

This role is used by images. TestComplete addresses such objects using the Alert type name.

ROLE_SYSTEM_GRIP

This role is used by specific mouse pointers, such as windows sizing grips. TestComplete addresses such objects using the Graphic type name.

ROLE_SYSTEM_GROUPING

This role is used by grouping controls. TestComplete addresses such objects using the Grouping type name.

ROLE_SYSTEM_HELPBALLOON

This role is used by controls that display help topics in the form of a tooltip or a help balloon. TestComplete addresses such controls using the HelpBalloon type name.

ROLE_SYSTEM_HOTKEYFIELD

This role is used by HotKey controls. TestComplete addresses such controls using the HotKeyField type name.

ROLE_SYSTEM_INDICATOR

This role is used by indicators (objects that point to something). TestComplete addresses such objects using the Indicator type name.

ROLE_SYSTEM_IPADDRESS

This role is used by IPAddress controls. TestComplete addresses such controls using the IpAddress type name.

ROLE_SYSTEM_LINK

This role is used by links. TestComplete addresses such objects using the Link type name.

ROLE_SYSTEM_LIST

This role is used by list box and list view controls. TestComplete addresses such controls using the List type name.

ROLE_SYSTEM_LISTITEM

This role is used by items in a list box or a combo box. TestComplete addresses such items using the ListItem type name.

ROLE_SYSTEM_MENUBAR

This role is used by menu bars. TestComplete addresses such controls using the MenuBar type name.

ROLE_SYSTEM_MENUITEM

This role is used by menu items. TestComplete addresses such items using the MenuItem type name.

ROLE_SYSTEM_MENUPOPUP

This role is used by drop-down and popup menus. TestComplete addresses such objects using the Popup type name.

ROLE_SYSTEM_OUTLINE

This role is used by tree view controls. TestComplete addresses such controls using the Outline type name.

ROLE_SYSTEM_OUTLINEBUTTON

This role is used by tree view items that expand or collapse upon a Space or Enter key press. TestComplete addresses such buttons using the OutlineButton type name.

ROLE_SYSTEM_OUTLINEITEM

This role is used by tree view items. TestComplete addresses such objects using the OutlineItem type name.

ROLE_SYSTEM_PAGETAB

This role is used by tabbed pages. TestComplete addresses such objects using the PageTab type name.

ROLE_SYSTEM_PANE

This role is used by panes within frame or document windows. TestComplete addresses such objects using the Pane type name.

ROLE_SYSTEM_PROGRESSBAR

This role is used by progress bar controls. TestComplete addresses such controls using the ProgressBar type name.

ROLE_SYSTEM_PROPERTYPAGE

This role is used by property sheets. TestComplete addresses such objects using the PropertyPage type name.

ROLE_SYSTEM_PUSHBUTTON

This role is used by push button controls. TestComplete addresses such controls using the Button type name.

ROLE_SYSTEM_RADIOBUTTON

This role is used by radio button controls. TestComplete addresses such controls using the RadioButton type name.

ROLE_SYSTEM_ROW

This role is used by rows within a table. TestComplete addresses such objects using the Row type name.

ROLE_SYSTEM_ROWHEADER

This role is used by row headers. TestComplete addresses such objects using the RowHeader type name.

ROLE_SYSTEM_SCROLLBAR

This role is used by scroll bar controls. TestComplete addresses such controls using the ScrollBar type name.

ROLE_SYSTEM_SEPARATOR

This role is used by separators within menus, toolbars or status bars. TestComplete addresses such objects using the Separator type name.

ROLE_SYSTEM_SLIDER

This role is used by slider controls. TestComplete addresses such controls using the Slider type name.

ROLE_SYSTEM_SOUND

This role is used by objects that correspond to system sounds. TestComplete addresses such objects using the Sound type name.

ROLE_SYSTEM_SPINBUTTON

This role is used by spin box controls. TestComplete addresses such controls using the SpinBox type name.

ROLE_SYSTEM_SPLITBUTTON

This role is used by split buttons. TestComplete addresses such buttons using the SplitButton type name.

ROLE_SYSTEM_STATICTEXT

This role is used by text labels. TestComplete addresses such controls using the Text type name.

ROLE_SYSTEM_STATUSBAR

This role is used by status bar controls. TestComplete addresses such controls using the StatusBar type name.

ROLE_SYSTEM_TABLE

This role is used by tables. TestComplete addresses such controls using the Table type name.

ROLE_SYSTEM_PAGETABLIST

This role is used by tab controls. TestComplete addresses such controls using the TabList type name.

ROLE_SYSTEM_TEXT

This role is used by text boxes. TestComplete addresses such controls using the Edit type name.

ROLE_SYSTEM_TITLEBAR

This role is used by title bars of windows. TestComplete addresses such objects using the TitleBar type name.

ROLE_SYSTEM_TOOLBAR

This role is used by toolbar controls. TestComplete addresses such controls using the ToolBar type name.

ROLE_SYSTEM_TOOLTIP

This role is used by tool tips. TestComplete addresses such objects using the ToolTip type name.

ROLE_SYSTEM_WHITESPACE

This role is used by objects that correspond to a whitespace between other objects. TestComplete addresses such objects using the WhiteSpace type name.

ROLE_SYSTEM_WINDOW

This role is used by window frames that contain child objects. TestComplete addresses these objects using one of the following type names that indicate the window type: Dialog, Form, MDIWindow, Panel, Popup or ToolWindow.

See Also

Using Microsoft Active Accessibility
Addressing Objects in MSAA Open Applications
MSAA Object Types by Names

Highlight search results