![]() |
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

