支持 macOS 的属性

下表列出了 macOS 环境中“获取属性”活动支持的桌面应用程序属性。

窗口属性

属性	描述
app	流程名称，例如 Google Chrome、Safari、计算器 (字符串)。
title	它指定有关元素的额外信息 (字符串)。当鼠标指针移到元素上时，通常会显示为工具提示文本。
tid	创建了包含该元素 (Int32) 的窗口的线程标识符。
pid	流程标识符 (Int32)。
角色	元素的角色（字符串）。例如按钮、链接。
enabled	指示元素是否已启用 (布尔值)。
focused	指示元素是否获得焦点 (布尔值)。
已选定	指示是否已选择元素 (布尔值)。
已展开	指示元素是否已展开 (布尔值)。
子系统	用于生成选取器的子系统 (字符串)。例如<wnd /> 。
text	它引用与给定的一个或一系列字符关联的所有字体、样式、对齐方式和其他格式设置 (字符串)。
应用程序路径	流程文件夹的完全限定路径（字符串）。例如/System/Applications/Calendar.app/Contents/MacOS/Calendar 。
应用程序命令行	一个字符串，表示用于启动目标所属流程的参数。例如，对于使用命令行/usr/bin/java -jar /Applications/TestApps/SwingSet2_withJava8.jar启动的应用程序，它将返回-jar /Applications/TestApps/SwingSet2_withJava8.jar 。
已最小化	如果应用程序已最小化，则返回true ，否则返回false （字符串）。
已最大化	如果应用程序已最大化，则返回true ，否则返回false （字符串）。
hwnd	它检索原生窗口句柄 (Int32)。
位置	元素位置 (矩形)。
比例因子	检索当前应用于该元素的比例因子 (Double)。在 macOS 上，比例因子和 DPI 比例因子通常等于 1。
显示 Dpi 比例因子	检索放置此元素的显示器的 DPI 比例因子 (Double)。在 macOS 上，比例因子和 DPI 比例因子通常等于 1。
是 Java 窗口	检查给定窗口是否实现 Java Accessibility API (布尔值)。
相对可见性	元素在其所有上级中的 (部分) 可见性 (布尔值)
可见	它指定与以下可见性级别对应的值: 0 - 可见、1 - 隐藏、2 - 屏幕外、3 - 部分 (NVisibilityLevel)。
前台	指示流程或浏览器标签页是否位于前台 (布尔值)。
如果禁用则更改
支持多页抓取
disabled	指示元素是否已禁用 (布尔值)。
只读	指示元素是否为只读 (布尔值)。
已选中	指示是否已预先选择元素（布尔值）。
项目
选定的项目	下拉列表元素的选定项目 (字符串)。
选定的项目
是 SAP Win GUI 会话	指示应用程序是否为 SAP 应用程序 (布尔值)。
SAP 客户端	适用于 SAP Windows。
SAP 语言	适用于 SAP Windows。
SAP 程序	适用于 SAP Windows。
SAP 就绪状态	适用于 SAP Windows。
SAP 屏幕	适用于 SAP Windows。
SAP 会话	适用于 SAP Windows。
SAP 系统名称	适用于 SAP Windows。
sap 系统编号	适用于 SAP Windows。
SAP 系统会话 ID	适用于 SAP Windows。
SAP 事务	适用于 SAP Windows。
SAP 用户	适用于 SAP Windows。
SAP 脚本编写状态	表示 SAP 脚本可用状态的枚举 (UiSAPScriptingStatus)。以下值是相关的： UI_SAP_SCRIPting_INTERNAL_ERROR = 0，UI_SAP_Script_DISABLED_BY_ADMiniSTRATOR = 2 适用于 SAP Windows。

Java 属性

属性	描述
aaname	用户界面元素名称。它表示所显示的文本，例如按钮上的“提交”或编辑框的“名字”。（字符串）。
accessibleClass	元素的可访问 Java 类 (字符串)。
可访问完整类	元素的可访问 Java 类的完全限定名称 (字符串)。
背景颜色	元素的背景色，其格式为“（红色、绿色、蓝色、Alpha）” (字符串)。
基类名称	元素的基本 Java 类 (字符串)。
已选中	用于指定是否预先选择元素的属性（布尔值）。
cls	它为元素指定一个或多个 CSS 类名称。或原生窗口句柄的类名称 (字符串)。
可编辑	指示元素是否可编辑 (布尔值)。
enabled	指示元素是否已启用 (布尔值)。
前景色	元素的前景色，其格式为“（红色、绿色、蓝色、Alpha）” (字符串)。
完整类名称	元素的 Java 类的完全限定名称 (字符串)。
拥有焦点	指示元素是否具有焦点 (布尔值)。
拥有表格上级	指示元素是否拥有角色为“table”的上级 (Int32)。
hwnd	它检索原生窗口句柄 (Int32)。
javastate	一个列表，其中包含 Java 类型控件的所有可用状态 (字符串)。例如，enabled、visible 和 editable。
位置	元素位置 (矩形)。
角色	元素的角色 (字符串)。例如，button 和 link
选定的项目	下拉列表元素的选定项目 (字符串)。
text	它引用与给定的一个或一系列字符关联的所有字体、样式、对齐方式和其他格式设置 (字符串)。
title	它指定有关元素的额外信息 (字符串)。当鼠标指针移到元素上时，通常会显示为工具提示文本。
virtualname	元素的可访问虚拟名称 (字符串)。例如，组合框的静态文本标签。
可见	指示元素是否可见 (布尔值)。
行计数
列计数
tableRow
tableCol
rowName
colName
组件名称
树深度
已展开
选定的项目
项目

SAP 属性

属性	描述
aastate	主动式辅助状态。标识控件的当前状态，例如对于复选框为已选中。状态会指示是否可以选择或聚焦控件和/或使用其他类型的可变功能。(字符串)。
已选中	可用于以下元素类型： GuiCheckBox 、 GuiRadioButton 、 GuiGridViewRow 、 GuiGridViewColumn 、 GuiGridViewCell 、 GuiGridViewAllItems 、 GuiTreeItem 、 TableCol 、 TableRow 、 TableAllItems 。
颜色索引	适用于以下元素类型： GuiCheckBox 、 GuiLabel 。
颜色增强	适用于以下元素类型： GuiCheckBox 、 GuiLabel 。
颜色反转	适用于以下元素类型： GuiCheckBox 、 GuiLabel 。
colName	适用于以下元素类型： GuiGridViewColumn 、 GuiGridViewCell 。
列工具提示	适用于以下元素类型： GuiGridViewCell 、 GuiGridView 。
列计数	适用于以下元素类型： GuiTableControl 、 TableCell 。
focused	指示元素是否获得焦点 (布尔值)。
聚焦项目	适用于GuiTree 。
拥有焦点	指示元素是否具有焦点 (布尔值)。
id	可用于所有 SAP 控件。
itemId	适用于GuiTreeItem 。
项目
labeledby	可用于所有 SAP 控件。
leafid	可用于所有 SAP 控件。
最大长度	可用于以下元素类型： GuiTextField 、 GuiCTextField 、 GuiPasswordField 。
name	可用于所有 SAP 控件。
位置	元素位置 (矩形)。
relpath	适用于GuiTreeNode 。
角色	元素的角色 (字符串)。例如，button 和 link
行计数	适用于以下元素类型： GuiTableControl 、 GuiGridView 。
SAP 客户端
SAP 语言
SAP 程序
SAP 就绪状态
SAP 屏幕
SAP 会话
SAP 系统名称
sap 系统编号
SAP 系统会话 ID
SAP 事务
SAP 用户
SAP 脚本编写状态	表示 SAP 脚本可用状态的枚举 (UiSAPScriptingStatus)。以下值是相关的： UI_SAP_SCRIPting_INTERNAL_ERROR = 0，UI_SAP_Script_DISABLED_BY_ADMiniSTRATOR = 2
最大滚动量	适用于GuiTableControl 。
滚动最小值	适用于GuiTableControl 。
滚动页面大小	适用于GuiTableControl 。
滚动位置	适用于GuiTableControl 。
选定的项目	下拉列表元素的选定项目 (字符串)。 可用于以下元素类型： GuiTree 、 GuiComboBox 、 GuiTabStrip 。
选定的项目
状态消息	适用于以下元素类型： GuiStatusbar 、 GuiStatusPane 。
状态消息 ID	适用于以下元素类型： GuiStatusbar 、 GuiStatusPane 。
状态消息编号	适用于以下元素类型： GuiStatusbar 、 GuiStatusPane 。
状态参数	适用于以下元素类型： GuiStatusbar 、 GuiStatusPane 。
状态类型	适用于以下元素类型： GuiStatusbar 、 GuiStatusPane 。
子系统	用于生成选取器的子系统 (字符串)。选取器的二级标签: webctrl、ctrl、uia、java、silverlight 和 sap。
tableCol	可用于以下元素类型： GuiGridViewColumn 、 GuiGridViewCell 、 TableCell 。
tableRow	可用于以下元素类型： GuiGridViewRow 、 GuiGridViewCell 、 TableCell 。
text	它引用与给定的一个或一系列字符关联的所有字体、样式、对齐方式和其他格式设置 (字符串)。 可用于所有 SAP 控件。
title	它指定有关元素的额外信息 (字符串)。当鼠标指针移到元素上时，通常会显示为工具提示文本。
工具提示	可用于所有 SAP 控件。
类型	可用于所有 SAP 控件。
virtualname	元素的可访问虚拟名称 (字符串)。例如，组合框的静态文本标签。
可见	它指定与以下可见性级别对应的值: 0 - 可见、1 - 隐藏、2 - 屏幕外、3 - 部分 (NVisibilityLevel)。
可见	指示元素是否可见 (布尔值)。

轴属性

属性	描述
角色	元素的角色 (字符串)。例如，button 和 link
subrole	元素的子角色提供有关元素的其他信息。例如：轴关闭按钮
name	元素的可访问名称 (字符串)。
title	它指定有关元素的额外信息 (字符串)。当鼠标指针移到元素上时，通常会显示为工具提示文本。
标识符	元素的唯一标识符，通常由应用程序提供。它在应用程序版本和操作系统版本之间不一定保持一致。
文件名	提供表示文件的元素的特定信息，例如，finder 应用程序中的文件项目。
url	它指定浏览器选项卡的 URL。它也可以出现在 探测器应用程序中表示文件项目并表示文件完整路径的项目上： file:///Users/{username}/Documents/EditableNonEditable/ （字符串）。
值	给出元素的值。表示文本元素的文本，表示复选框的 0 或 1 等 (字符串)。
帮助	为元素提供附加说明文本 (字符串)。
enabled	指示元素是否已启用 (布尔值)。
focused	指示元素是否获得焦点 (布尔值)。
已选定	指示是否已选择元素 (布尔值)。
已展开	指示元素是否已展开 (布尔值)。
已选中	指示是否已预先选择元素（布尔值）。
项目
选定的项目	下拉列表元素的选定项目 (字符串)。
选定的项目