Supported Attributes for macOS

The following tables present the supported attributes for desktop applications in a macOS environment, from the Get Attribute activity.

Window attributes

Attribute	Description
app	The process name such as Google Chrome, Safari, Calculator (String).
title	It specifies extra information about an element (String). Most often shown as a tooltip text when the mouse moves over the element.
tid	The identifier of the thread that created the window containing the element (Int32).
pid	The process identifier (Int32).
role	The role of an element (String). E.g. button, link.
enabled	Indicates if the element is enabled (Boolean).
focused	Indicates if the element is focused (Boolean).
selected	Indicates if the element is selected (Boolean).
expanded	Indicates if the element is expanded (Boolean).
subsystem	The subsystem used to generate the selector (String). E.g. <wnd />.
text	The text content of the element (String).
AppPath	The fully qualified path of the process' folder (String). E.g. /System/Applications/Calendar.app/Contents/MacOS/Calendar.
AppCmdLine	A string representing the arguments used to start the process the target belongs to. For example, it would return -jar /Applications/TestApps/SwingSet2_withJava8.jar for an application started with the command line: /usr/bin/java -jar /Applications/TestApps/SwingSet2_withJava8.jar.
isminimized	Returns true if the application is minimized, false otherwise (String).
ismaximized	Returns true if the application is maximized, false otherwise (String).
hwnd	It retrieves the native window handle (Int32).
position	The element position (Rectangle).
scaleFactor	Retrieves the scale factor that is currently applied to this element (Double). On macOS scale factor and DPI scale factor are generally equal to 1.
displayDpiScaleFactor	Retrieves the DPI scale factor of the display on which this element is placed (Double). On macOS scale factor and DPI scale factor are generally equal to 1.
IsJavaWindow	Checks if the given window implements the Java Accessibility API (Boolean).
relativeVisibility	The (partial) visibility of an element inside all of its ancestors (Boolean)
visibility	It specifies a value corresponding to the following visibility levels: 0 - Visible, 1 - Hidden, 2 - Offscreen, 3 - Partial (NVisibilityLevel).
foreground	Indicates if the process or browser tab is in foreground or not (Boolean).
disabled	Indicates if the element is disabled (Boolean).
readonly	Indicates if the element is read only (Boolean).
checked	Indicates if the element is pre-selected (Boolean).
items	All items of a dropdown element or list.
selecteditem	The selected item of a dropdown element (String).
selecteditems	Selected items, if the element supports multiple selection.
isSapWinGuiSession	Indicates if the application is a SAP application (Boolean).
sapClient	Available for SAP windows.
sapLanguage	Available for SAP windows.
sapProgram	Available for SAP windows.
sapReadyState	Available for SAP windows.
sapScreen	Available for SAP windows.
sapSession	Available for SAP windows.
sapSysName	Available for SAP windows.
sapSysNumber	Available for SAP windows.
sapSysSessionId	Available for SAP windows.
sapTransaction	Available for SAP windows.
sapUser	Available for SAP windows.
sapScriptingStatus	Enum (UiSapScriptingStatus) representing the state of availabilty for SAP scripting. The following values are relevant: UI_SAP_SCRIPTING_INTERNAL_ERROR = 0, UI_SAP_SCRIPTING_DISABLED_BY_ADMINISTRATOR = 2 Available for SAP windows.

Java attributes

Attribute	Description
aaname	The UI element name. It represents the text that is displayed, such as 'Submit' on a button or 'First Name' for an edit box. (String).
accessibleClass	The accessible Java class of the element (String).
accessibleFullClass	The fully qualified accessible Java class of the element (String).
backgroundColor	The background color of the element formatted as ‘(Red, Green, Blue, Alpha)’ (String).
baseClassName	The underlying base Java class of the element (String).
checked	An attribute which specifies that an element is pre-selected (Boolean).
cls	It specifies one or more CSS classnames for an element. Or the class name of a native window handle (String).
editable	Indicates if the element is editable (Boolean).
enabled	Indicates if the element is enabled (Boolean).
foregroundColor	The foreground color of the element formatted as ‘(Red, Green, Blue, Alpha)’ (String).
fullClassName	The fully qualified name of the Java class of the element (String).
hasFocus	Indicates whether the element has focus or not (Boolean).
hasTableAncestor	Indicates whether the element has an ancestor with role ‘table’ or not (Int32).
hwnd	It retrieves the native window handle (Int32).
javastate	A list with all the available states of a java type of control (String). E.g. enabled, visible, editable.
position	The element position (Rectangle).
role	The role of an element (String). E.g. button, link
selecteditem	The selected item of a dropdown element (String).
text	The text content of the element (String)
title	It specifies extra information about an element (String). Most often shown as a tooltip text when the mouse moves over the element.
virtualname	The accessible virtual name of the element (String). E.g. the static text label for a combo box.
visible	Indicates if the element is visible (Boolean).
rowCount	Available for Table elements.
columnCount	Available for Table elements.
tableRow	Available for Table elements.
tableCol	Available for Table elements.
rowName	Available for Table elements.
colName	Available for Table elements.
componentName
treeDepth
isExpanded
selecteditems	Selected items, if the element supports multiple selection.
items

SAP attributes

Attribute	Description
aastate	An array of element states, for example, "visible, enabled, selected". (String).
checked	Available for the following element types: GuiCheckBox, GuiRadioButton, GuiGridViewRow, GuiGridViewColumn, GuiGridViewCell, GuiGridViewAllItems, GuiTreeItem, TableCol, TableRow, TableAllItems.
colorIndex	Available for the following element types: GuiCheckBox, GuiLabel.
colorIntensified	Available for the following element types: GuiCheckBox, GuiLabel.
colorInverse	Available for the following element types: GuiCheckBox, GuiLabel.
colName	Available for the following element types: GuiGridViewColumn, GuiGridViewCell.
colTooltip	Available for the following element types: GuiGridViewCell, GuiGridView.
columnCount	Available for the following element types: GuiTableControl, TableCell.
focused	Indicates if the element is focused (Boolean).
focuseditem	Available for GuiTree.
hasFocus	Indicates whether the element has focus or not (Boolean).
id	Available for all SAP controls.
itemId	Available for GuiTreeItem.
items
labeledby	Available for all SAP controls.
leafid	Available for all SAP controls.
maxLength	Available for the following element types: GuiTextField, GuiCTextField, GuiPasswordField.
name	Available for all SAP controls.
position	The element position (Rectangle).
relpath	Available for GuiTreeNode.
role	The role of an element (String). E.g. button, link
rowCount	Available for the following element types: GuiTableControl, GuiGridView.
sapClient	Available for both SAP windows and SAP controls.
sapLanguage	Available for both SAP windows and SAP controls.
sapProgram	Available for both SAP windows and SAP controls.
sapReadyState	Available for both SAP windows and SAP controls.
sapScreen	Available for both SAP windows and SAP controls.
sapSession	Available for both SAP windows and SAP controls.
sapSysName	Available for both SAP windows and SAP controls.
sapSysNumber	Available for both SAP windows and SAP controls.
sapSysSessionId	Available for both SAP windows and SAP controls.
sapTransaction	Available for both SAP windows and SAP controls.
sapUser	Available for both SAP windows and SAP controls.
sapScriptingStatus	Enum (UiSapScriptingStatus) representing the state of availabilty for SAP scripting. The following values are relevant: UI_SAP_SCRIPTING_INTERNAL_ERROR = 0, UI_SAP_SCRIPTING_DISABLED_BY_ADMINISTRATOR = 2
scrollmax	Available for GuiTableControl.
scrollmin	Available for GuiTableControl.
scrollpagesize	Available for GuiTableControl.
scrollpos	Available for GuiTableControl.
selecteditem	The selected item of a dropdown element (String). Available for the following element types: GuiTree, GuiComboBox, GuiTabStrip.
selectedItems	Selected items, if the element supports multiple selection.
statusMessage	Available for the following element types: GuiStatusbar, GuiStatusPane.
statusMessageId	Available for the following element types: GuiStatusbar, GuiStatusPane.
statusMessageNumber	Available for the following element types: GuiStatusbar, GuiStatusPane.
statusParameters	Available for the following element types: GuiStatusbar, GuiStatusPane.
statusType	Available for the following element types: GuiStatusbar, GuiStatusPane.
subsystem	The subsystem used to generate the selector (String). The selector's second level tag: webctrl, ctrl, uia, java, silverlight, sap.
tableCol	Available for the following element types: GuiGridViewColumn, GuiGridViewCell, TableCell.
tableRow	Available for the following element types: GuiGridViewRow, GuiGridViewCell, TableCell.
text	It refers to all of the font, style, alignment, and other formatting associated with a given character or series of characters (String). Available for all SAP controls.
title	It specifies extra information about an element (String). Most often shown as a tooltip text when the mouse moves over the element.
tooltip	Available for all SAP controls.
type	Available for all SAP controls.
virtualname	The accessible virtual name of the element (String). E.g. the static text label for a combo box.
visibility	It specifies a value corresponding to the following visibility levels: 0 - Visible, 1 - Hidden, 2 - Offscreen, 3 - Partial (NVisibilityLevel).
visible	Indicates if the element is visible (Boolean).

AX attributes

Attribute	Description
role	The role of an element (String). E.g. button, link
subrole	Subrole of an element, provides additional info on the element. E.g.: AXCloseButton
name	The accessible name of the element (String).
title	It specifies extra information about an element (String). Most often shown as a tooltip text when the mouse moves over the element.
identifier	Unique identifier of an element that is often provided by the application. It is not necessarily consistent across application versions and OS versions.
filename	Provides specific information for elements that represent FIles, for example, file items in Finder application.
url	It specifies the URL of a browser tab. It can also be found on items that represent file items in Finder application and represent a full path to the file: file:///Users/{username}/Documents/EditableNonEditable/ (String).
value	Gives the value of an element. Represented by the text for text elements, 0 or 1 for checkboxes, and so on (String).
help	Provides an additional description text for the element (String).
enabled	Indicates if the element is enabled (Boolean).
focused	Indicates if the element is focused (Boolean).
selected	Indicates if the element is selected (Boolean).
expanded	Indicates if the element is expanded (Boolean).
checked	Indicates if the element is pre-selected (Boolean).
items
selecteditem	The selected item of a dropdown element (String).
selecteditems	Selected items, if the element supports multiple selection.