映射图像网格

动词：mapGrid

可从以下位置获取: <Standard>

根据映射中的信息，映射由图像表示的用户界面控件的网格。

在 Windows 上下文中，控件是允许用户与应用程序进行交互的元素。控件可以是按钮、数据输入字段、菜单和各种其他元素。

语法

mapGrid [--columnmappings(String)] [--hascolumnheaders(Boolean)] [--hasrowheaders(Boolean)] [--hasbandrows(Boolean)] [--forcerefresh(Boolean)] --selector(ControlSelectors) --id(String) --name(String) --innertext(String) --tagname(String) --xpath(String) --classname(String) --elementvalue(String) --controltype(Nullable<ControlTypes>) --index(Numeric) --control(Control) [--usetable(Boolean)] [--searchbycolumn(Boolean)] --searchcolumn(String) --searchvalue(String) --returncolumn(String) --row(Numeric) [--timeout(TimeSpan)] (ImageGrid)=value (Numeric)=rows (Numeric)=columns

输入

脚本	设计器	必需的	AcceptedTypes	Description
--columnmappings	映射	可选	文本	映射的网格的每列的位置（以像素为单位）。此参数中的网格映射包含每个映射的网格列的开始和结束位置（以像素为单位）。映射格式如下所示：[列开头的像素-列末尾的像素; 下一列开头的像素-下一列末尾的像素]，依此类推。示例：0-20; 20-40; 40-60。可以借助记录器获取网格的映射。
--hascolumnheaders	列标题	可选	BOOLEAN	启用后，将确定网格的列具有标题。
--hasrowheaders	行标题	可选	BOOLEAN	启用后，将确定网格的行具有标题。
--hasbandrows	交替行颜色	可选	BOOLEAN	启用后，将确定网格线的背景色是交替的。
--forcerefresh	更新屏幕高速缓存	可选	BOOLEAN	启用后，将在执行命令之前执行屏幕的新读取，以识别新元素并更新屏幕高速缓存。要正确运行命令，必须进行此识别，以防屏幕上有任何更改。
--selector	选择器	必需的	ControlSelectors	用于识别用户界面控件的选择器的类型。提供了以下选项：类和值类名 Id 标识和名称内部文本和控件类型实例 Name 名称和值类型和索引类型和名称 xpath 除了在脚本中插入带有自动填充这些参数的命令外，还可以使用 IBM RPA Studio的记录器来映射控件并获取 "选择器" 参数的必要信息。该记录器在平台上的上方工具栏中可用。
-- 标识	标识	仅当“选择器”为“标识”或“标识和名称”时	文本	用户界面控件的标识。
-- 名称	名称	仅当“选择器”为“名称”、“名称和值”、“标识和名称”或“类型和名称”时	文本	用户界面控件的名称。
--innertext	文本	仅当“选择器”为“内部文本和标记”时	文本	用户界面控件元素的内部文本。
--tagname	元素类型	仅当“选择器”为“内部文本和标记”时	文本	元素或标记的类型。示例：“按钮”和“文本框”。
--xpath	XPath	仅当“选择器”为“XPath”时	文本	用户界面控件的 XPath。
--classname	类	仅当“选择器”为“类和值”或“类名”时	文本	用户界面控件的类。
--elementvalue	元素值	仅当“选择器”为“类和值”或“名称和值”时	文本	用户界面控件元素的当前值。
--controltype	类型	仅当“选择器”为“类型和索引”或“类型和名称”时	ControlTypes	用户界面控件的类型。选项：按钮复选框子窗口组合框常规图像标签列表框菜单栏菜单项进度条单选按钮滚动条滑块微调器状态栏选项卡页面选项卡面板表文本框切换按钮树形视图 TreeTable 窗口
-- 索引	索引	仅当“选择器”为“类型和索引”时	成员	用户界面控件的索引。
--control	控件	仅当“选择器”为“实例”时	控件	控件实例。使用命令搜索控件获取此变量。
--usetable	表中的元素	可选	BOOLEAN	启用后，将在表中搜索元素。
--searchbycolumn	按列搜索	可选	BOOLEAN	启用后，将按列而不是按行搜索元素。
--searchcolumn	列	仅当“表中的元素”为 True 时	文本	必须从中获取元素的列的名称或编号。
--searchvalue	值	仅当“按列搜索”为 True 时	文本	用于在表中查找元素的值。
--returncolumn	返回列	仅当“按列搜索”为 True 时	文本	包含控件的列。
--row	行	仅当“按列搜索”为 False 时	成员	从中获取元素的表行。
--timeout	超时	可选	时间范围、数字、文本	执行命令的最长时间。如果在超时参数中未定义任何值，那么执行将使用设置超时命令定义的上下文时间。如果脚本未使用此命令，那么缺省时间为 5 秒。

输出

脚本	设计器	AcceptedTypes	Description
值	网格	图像网格	已映射的网格。
行	行	成员	已映射网格中的行数。
columns	列数	成员	已映射网格中的列数。

示例

使用启动并附加窗口命令打开“MS 画图”窗口。之后，使用映射图像网格命令将颜色选择字段映射为控件网格。使用单击单元格命令，在映射的网格中单击前三种颜色，这些颜色由映射的网格中第一行的前三列表示。

defVar --name mappedImageGrid --type ImageGrid
launchWindow --executablepath "mspaint.exe"
// Mapping the Paint grid.
mapGrid --columnmappings "1-21;21-43;43-66;66-87;87-109;109-132;132-153;153-175;175-198;198-218;" --selector "XPath" --xpath "/root/pane[3]/pane[1]/pane[1]/pane[1]/pane[1]/pane[1]/custom[1]/custom[1]/toolbar[1]/group[1]" mappedImageGrid=value
// Click on the first three colors of the mapped Paint grid.
clickGrid --grid ${mappedImageGrid} --row 1 --column 1
clickGrid --grid ${mappedImageGrid} --row 1 --column 2
clickGrid --grid ${mappedImageGrid} --row 1 --column 3