MSAA Object Types by Names

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

To name the application’s objects that are exposed by the Microsoft Active Accessibility Support plugin, 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 the type names corresponding to the accessibility roles (in alphabetic order). For a list of type names sorted by accessibility roles, see MSAA Object Types by Accessibility Roles.

Click a letter to jump to the needed name quickly:
A   B   C   D   E   F   G   H   I   L   M   O   P   R   S   T   W

Alert

This type is used for objects that correspond to alerts (these objects have the ROLE_SYSTEM_ALERT role).

Animation

This type is used for animation controls (these controls have the ROLE_SYSTEM_ANIMATION role).

Application

This type is used for an application’s main window (such windows have the ROLE_SYSTEM_APPLICATION role).

Border

This type is used for window borders (these objects have the ROLE_SYSTEM_BORDER role).

Button

This type is used for push button controls (these controls have the ROLE_SYSTEM_PUSHBUTTON role).

Caret

This type is used for the object that represents the system caret (this object has the ROLE_SYSTEM_CARET role).

Cell

This type is used for table cells (these objects have the ROLE_SYSTEM_CELL role).

Character

This type is used for cartoon-like graphic objects, such as the Microsoft Office Assistant (these objects have the ROLE_SYSTEM_CHARACTER role).

Chart

This type is used for charts (these objects have the ROLE_SYSTEM_CHART role).

CheckBox

This type is used for check box controls (these controls have the ROLE_SYSTEM_CHECKBUTTON role).

Client

This type is used for a window’s client area (these objects have the ROLE_SYSTEM_CLIENT role).

Clock

This type is used for controls that display time (these controls have the ROLE_SYSTEM_CLOCK role).

Column

This type is used for a columns within a table (these objects have the ROLE_SYSTEM_COLUMN role).

ColumnHeader

This type is used for column headers (these objects have the ROLE_SYSTEM_COLUMNHEADER role).

ComboBox

This type is used for combo box controls (these controls have the ROLE_SYSTEM_COMBOBOX role).

Cursor

This type is used for the system mouse pointer (this object has the ROLE_SYSTEM_CURSOR role).

Diagram

This type is used for diagrams (these objects have the ROLE_SYSTEM_DIAGRAM role).

Dial

This type is used for dials and knobs (these objects have the ROLE_SYSTEM_DIAL role).

Dialog

This type is used for dialogs and message boxes (these objects have either the ROLE_SYSTEM_DIALOG role or the ROLE_SYSTEM_WINDOW role and the WS_EX_DLGMODALFRAME extended style).

Document

This type is used for document windows in MDI applications (these windows have the ROLE_SYSTEM_DOCUMENT role).

DropDown

This type is used for calendar and drop-down controls (these controls have the ROLE_SYSTEM_DROPLIST role).

DropDownButton

This type is used for buttons that drop down a list of items (these controls have the ROLE_SYSTEM_BUTTONDROPDOWN role).

Edit

This type is used for text boxes (these controls have the ROLE_SYSTEM_TEXT role).

Equation

This type is used for objects that correspond to mathematical equations (these objects have the ROLE_SYSTEM_EQUATION role).

Form

This type is used for an application’s top-level windows (that is, windows that have the ROLE_SYSTEM_WINDOW role and have no parent window).

Graphic

This type is used for images (these objects have the ROLE_SYSTEM_GRAPHIC role).

GridDropDownButton

This type is used for buttons that drop down a grid (these controls have the ROLE_SYSTEM_BUTTONDROPDOWNGRID role).

Grip

This type is used for specific mouse pointers, such as windows sizing grips (these objects have the ROLE_SYSTEM_GRIP role).

Grouping

This type is used for grouping controls (these controls have the ROLE_SYSTEM_GROUPING role).

HelpBalloon

This type is used for controls that display help topics in the form of a tooltip or a help balloon (these controls have the ROLE_SYSTEM_HELPBALLOON role).

HotKeyField

This type is used for HotKey controls (these controls have the ROLE_SYSTEM_HOTKEYFIELD role).

Indicator

This type is used for indicators, that is, objects that point to something (these objects have the ROLE_SYSTEM_INDICATOR role).

IpAddress

This type is used for IPAddress controls (these controls have the ROLE_SYSTEM_IPADDRESS role).

Link

This type is used for links (these objects have the ROLE_SYSTEM_LINK role).

List

This type is used for list box and list view controls (these controls have the ROLE_SYSTEM_LIST role).

ListItem

This type is used for items in a list box or a combo box (these objects have the ROLE_SYSTEM_LISTITEM role).

MDIWindow

This type is used for MDI child windows (these objects have the ROLE_SYSTEM_WINDOW role in combination with the WS_EX_MDICHILD extended style).

MenuBar

This type is used for menu bars (these controls have the ROLE_SYSTEM_MENUBAR role).

MenuButton

This type is used for buttons that drop down a menu (these controls have the ROLE_SYSTEM_BUTTONMENU role).

MenuItem

This type is used for menu items (these objects have the ROLE_SYSTEM_MENUITEM role).

Outline

This type is used for tree view controls (these controls have the ROLE_SYSTEM_OUTLINE role).

OutlineButton

This type is used for tree view items that expand or collapse upon a Space or Enter key press (these objects have the ROLE_SYSTEM_OUTLINEBUTTON role).

OutlineItem

This type is used for tree view items (these objects have the ROLE_SYSTEM_OUTLINEITEM role).

PageTab

This type is used for tabbed pages (these objects have the ROLE_SYSTEM_PAGETAB role).

Pane

This type is used for panes within frame or document windows. (these objects have the ROLE_SYSTEM_PANE role).

Panel

This type is used for window frames, which contain child objects (these objects have the ROLE_SYSTEM_WINDOW role).

Popup

This type is used for drop-down and popup menus (these objects have the ROLE_SYSTEM_MENUPOPUP role) and for popup windows (they have the ROLE_SYSTEM_WINDOW role and the WS_POPUPWINDOW style).

ProgressBar

This type is used for progress bar controls (these controls have the ROLE_SYSTEM_PROGRESSBAR role).

PropertyPage

This type is used for property sheets (these objects have the ROLE_SYSTEM_PROPERTYPAGE role).

RadioButton

This type is used for radio button controls (these controls have the ROLE_SYSTEM_RADIOBUTTON role).

Row

This type is used for rows within a table (these objects have the ROLE_SYSTEM_ROW role).

RowHeader

This type is used for row headers (these objects have the ROLE_SYSTEM_ROWHEADER role).

ScrollBar

This type is used for scroll bar controls (these controls have the ROLE_SYSTEM_SCROLLBAR role).

Separator

This type is used for separators within menus, toolbars or status bars (these objects have the ROLE_SYSTEM_SEPARATOR role).

Slider

This type is used for slider controls (these controls have the ROLE_SYSTEM_SLIDER role).

Sound

This type is used for objects that correspond to system sounds (these objects have the ROLE_SYSTEM_SOUND role).

SpinBox

This type is used for spin box controls (these controls have the ROLE_SYSTEM_SPINBUTTON role).

SplitButton

This type is used for split buttons (these controls have the ROLE_SYSTEM_SPLITBUTTON role).

StatusBar

This type is used for status bar controls (these controls have the ROLE_SYSTEM_STATUSBAR role).

Table

This type is used for tables (these objects have the ROLE_SYSTEM_TABLE role).

TabList

This type is used for tab controls (these controls have the ROLE_SYSTEM_PAGETABLIST role).

Text

This type is used for text labels (these controls have the ROLE_SYSTEM_STATICTEXT role).

TitleBar

This type is used for title bars of windows (these objects have the ROLE_SYSTEM_TITLEBAR role).

ToolBar

This type is used for tool bar controls (these controls have the ROLE_SYSTEM_TOOLBAR role).

ToolTip

This type is used for tool tips (these objects have the ROLE_SYSTEM_TOOLTIP role).

ToolWindow

This type is used for tool windows (these objects have the ROLE_SYSTEM_WINDOW role in combination with the WS_EX_TOOLWINDOW extended style).

WhiteSpace

This type is used for objects that correspond to a whitespace between other objects (these objects have the ROLE_SYSTEM_WHITESPACE role).

See Also

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

Highlight search results