activities
latest
false
UiPath logo, featuring letters U and I in white

UI Automation Activities

Last updated Aug 27, 2025

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

AttributeDescription
appThe process name such as Google Chrome, Safari, Calculator (String).
titleIt specifies extra information about an element (String). Most often shown as a tooltip text when the mouse moves over the element.
tidThe identifier of the thread that created the window containing the element (Int32).
pidThe process identifier (Int32).
roleThe role of an element (String). E.g. button, link.
enabledIndicates if the element is enabled (Boolean).
focusedIndicates if the element is focused (Boolean).
selectedIndicates if the element is selected (Boolean).
expandedIndicates if the element is expanded (Boolean).
subsystemThe subsystem used to generate the selector (String). E.g. <wnd />.
textIt refers to all of the font, style, alignment, and other formatting associated with a given character or series of characters (String).
AppPathThe fully qualified path of the process' folder (String). E.g. /System/Applications/Calendar.app/Contents/MacOS/Calendar.
AppCmdLineA 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.
isminimizedReturns true if the application is minimized, false otherwise (String).
ismaximizedReturns true if the application is maximized, false otherwise (String).
hwndIt retrieves the native window handle (Int32).
positionThe element position (Rectangle).
scaleFactorRetrieves the scale factor that is currently applied to this element (Double). On macOS scale factor and DPI scale factor are generally equal to 1.
displayDpiScaleFactorRetrieves 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.
IsJavaWindowChecks if the given window implements the Java Accessibility API (Boolean).
relativeVisibilityThe (partial) visibility of an element inside all of its ancestors (Boolean)
visibilityIt specifies a value corresponding to the following visibility levels: 0 - Visible, 1 - Hidden, 2 - Offscreen, 3 - Partial (NVisibilityLevel).
foregroundIndicates if the process or browser tab is in foreground or not (Boolean).
alterIfDisabled 
supportsMultipageScraping 
disabledIndicates if the element is disabled (Boolean).
readonlyIndicates if the element is read only (Boolean).
checkedIndicates if the element is pre-selected (Boolean).
items 
selecteditemThe selected item of a dropdown element (String).
selecteditems 
isSapWinGuiSessionIndicates if the application is a SAP application (Boolean).
sapClientAvailable for SAP windows.
sapLanguageAvailable for SAP windows.
sapProgramAvailable for SAP windows.
sapReadyStateAvailable for SAP windows.
sapScreenAvailable for SAP windows.
sapSessionAvailable for SAP windows.
sapSysNameAvailable for SAP windows.
sapSysNumberAvailable for SAP windows.
sapSysSessionIdAvailable for SAP windows.
sapTransactionAvailable for SAP windows.
sapUserAvailable 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

AttributeDescription
aanameThe UI element name. It represents the text that is displayed, such as 'Submit' on a button or 'First Name' for an edit box. (String).
accessibleClassThe accessible Java class of the element (String).
accessibleFullClassThe fully qualified accessible Java class of the element (String).
backgroundColorThe background color of the element formatted as ‘(Red, Green, Blue, Alpha)’ (String).
baseClassNameThe underlying base Java class of the element (String).
checkedAn attribute which specifies that an element is pre-selected (Boolean).
clsIt specifies one or more CSS classnames for an element. Or the class name of a native window handle (String).
editableIndicates if the element is editable (Boolean).
enabledIndicates if the element is enabled (Boolean).
foregroundColorThe foreground color of the element formatted as ‘(Red, Green, Blue, Alpha)’ (String).
fullClassNameThe fully qualified name of the Java class of the element (String).
hasFocusIndicates whether the element has focus or not (Boolean).
hasTableAncestorIndicates whether the element has an ancestor with role ‘table’ or not (Int32).
hwndIt retrieves the native window handle (Int32).
javastateA list with all the available states of a java type of control (String). E.g. enabled, visible, editable.
positionThe element position (Rectangle).
roleThe role of an element (String). E.g. button, link
selecteditemThe selected item of a dropdown element (String).
textIt refers to all of the font, style, alignment, and other formatting associated with a given character or series of characters (String).
titleIt specifies extra information about an element (String). Most often shown as a tooltip text when the mouse moves over the element.
virtualnameThe accessible virtual name of the element (String). E.g. the static text label for a combo box.
visibleIndicates if the element is visible (Boolean).
rowCount 
columnCount 
tableRow 
tableCol 
rowName 
colName 
componentName 
treeDepth 
isExpanded 
selecteditems 
items 

SAP attributes

AttributeDescription
aastateThe Active Accessibility state. Identifies the current condition of the control, such as checked for a checkbox. State advises whether a control can be selected, focused, and/or other types of changeable functionality. (String).
checkedAvailable for the following element types: GuiCheckBox, GuiRadioButton, GuiGridViewRow, GuiGridViewColumn, GuiGridViewCell, GuiGridViewAllItems, GuiTreeItem, TableCol, TableRow, TableAllItems.
colorIndexAvailable for the following element types: GuiCheckBox, GuiLabel.
colorIntensifiedAvailable for the following element types: GuiCheckBox, GuiLabel.
colorInverseAvailable for the following element types: GuiCheckBox, GuiLabel.
colNameAvailable for the following element types: GuiGridViewColumn, GuiGridViewCell.
colTooltipAvailable for the following element types: GuiGridViewCell, GuiGridView.
columnCountAvailable for the following element types: GuiTableControl, TableCell.
focusedIndicates if the element is focused (Boolean).
focuseditemAvailable for GuiTree.
hasFocusIndicates whether the element has focus or not (Boolean).
idAvailable for all SAP controls.
itemIdAvailable for GuiTreeItem.
items 
labeledbyAvailable for all SAP controls.
leafidAvailable for all SAP controls.
maxLengthAvailable for the following element types: GuiTextField, GuiCTextField, GuiPasswordField.
nameAvailable for all SAP controls.
positionThe element position (Rectangle).
relpathAvailable for GuiTreeNode.
roleThe role of an element (String). E.g. button, link
rowCountAvailable for the following element types: GuiTableControl, GuiGridView.
sapClient 
sapLanguage 
sapProgram 
sapReadyState 
sapScreen 
sapSession 
sapSysName 
sapSysNumber 
sapSysSessionId 
sapTransaction 
sapUser 
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

scrollmaxAvailable for GuiTableControl.
scrollminAvailable for GuiTableControl.
scrollpagesizeAvailable for GuiTableControl.
scrollposAvailable for GuiTableControl.
selecteditem

The selected item of a dropdown element (String).

Available for the following element types: GuiTree, GuiComboBox, GuiTabStrip.
selectedItems 
statusMessageAvailable for the following element types: GuiStatusbar, GuiStatusPane.
statusMessageIdAvailable for the following element types: GuiStatusbar, GuiStatusPane.
statusMessageNumberAvailable for the following element types: GuiStatusbar, GuiStatusPane.
statusParametersAvailable for the following element types: GuiStatusbar, GuiStatusPane.
statusTypeAvailable for the following element types: GuiStatusbar, GuiStatusPane.
subsystemThe subsystem used to generate the selector (String). The selector's second level tag: webctrl, ctrl, uia, java, silverlight, sap.
tableColAvailable for the following element types: GuiGridViewColumn, GuiGridViewCell, TableCell.
tableRowAvailable 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.

titleIt specifies extra information about an element (String). Most often shown as a tooltip text when the mouse moves over the element.
tooltipAvailable for all SAP controls.
typeAvailable for all SAP controls.
virtualnameThe accessible virtual name of the element (String). E.g. the static text label for a combo box.
visibilityIt specifies a value corresponding to the following visibility levels: 0 - Visible, 1 - Hidden, 2 - Offscreen, 3 - Partial (NVisibilityLevel).
visibleIndicates if the element is visible (Boolean).

AX attributes

AttributeDescription
roleThe role of an element (String). E.g. button, link
subroleSubrole of an element, provides additional info on the element. E.g.: AXCloseButton
nameThe accessible name of the element (String).
titleIt specifies extra information about an element (String). Most often shown as a tooltip text when the mouse moves over the element.
identifierUnique identifier of an element that is often provided by the application. It is not necessarily consistent across application versions and OS versions.
filenameProvides specific information for elements that represent FIles, for example, file items in Finder application.
urlIt 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).
valueGives the value of an element. Represented by the text for text elements, 0 or 1 for checkboxes, and so on (String).
helpProvides an additional description text for the element (String).
enabledIndicates if the element is enabled (Boolean).
focusedIndicates if the element is focused (Boolean).
selectedIndicates if the element is selected (Boolean).
expandedIndicates if the element is expanded (Boolean).
checkedIndicates if the element is pre-selected (Boolean).
items 
selecteditemThe selected item of a dropdown element (String).
selecteditems 
  • Supported Attributes for macOS
  • Window attributes
  • Java attributes
  • SAP attributes
  • AX attributes

Was this page helpful?

Get The Help You Need
Learning RPA - Automation Courses
UiPath Community Forum
Uipath Logo
Trust and Security
© 2005-2025 UiPath. All rights reserved.