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