使值偏移
动词：offsetValue
按单位对跟踪条的值进行偏移，以将其减小或增大。
语法
offsetValue [--decrease(Boolean)] --modifyby(Numeric) --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)] (Numeric)=value
输入
| 脚本 | 设计器 | 必需的 | AcceptedTypes | Description |
|---|---|---|---|---|
| --decrease | 减小 | 可选 | BOOLEAN | 启用后，将减小元素的值。将其保留为禁用可增大该值。 |
| --modifyby | 抵销 | 必需的 | 成员 | 表示要使跟踪条从其当前位置偏移的单位数量的数字。 |
| --selector | 选择器 | 必需的 | ControlSelectors | 用于识别用户界面控件的选择器的类型。 提供了以下选项：除了在脚本中插入带有自动填充这些参数的命令外，还可以使用 IBM RPA Studio的记录器来映射控件并获取 "选择器" 参数的必要信息。 该记录器在平台上的上方工具栏中可用。 |
| -- 标识 | 标识 | 仅当“选择器”为“标识”或“标识和名称”时 | 文本 | 应从其更改跟踪条值的用户界面控件的标识。 |
| -- 名称 | 名称 | 仅当“选择器”为“名称”、“名称和值”、“标识和名称”或“类型和名称”时 | 文本 | 应从其更改跟踪条值的用户界面控件的名称。 |
| --innertext | 文本 | 仅当“选择器”为“内部文本和标记”时 | 文本 | 应从其更改跟踪条值的用户界面控件的内部文本。 |
| --tagname | 元素值 | 仅当“选择器”为“内部文本和标记”时 | 文本 | 应从其更改跟踪条值的元素的类型。 |
| --xpath | XPath | 仅当“选择器”为“XPath”时 | 文本 | 将转至应从其更改跟踪条值的控件的 XPath。 |
| --classname | 类 | 仅当“选择器”为“类和值”或“类名”时 | 文本 | 应从其更改跟踪条值的用户界面控件的类。 |
| --elementvalue | 元素值 | 仅当“选择器”为“类和值”或“名称和值”时 | 文本 | 应从其更改跟踪条值的用户界面控件的当前值。 |
| --controltype | 类型 | 仅当“选择器”为“类型和索引”或“类型和名称”时 | ControlTypes | 应从其更改跟踪条值的用户界面控件的类型。 选项： |
| -- 索引 | 索引 | 仅当“选择器”为“类型和索引”时 | 成员 | 应从其更改跟踪条值的用户界面控件的索引。 |
| --control | 控件 | 仅当“选择器”为“实例”时 | 控件 | 控件实例。使用命令搜索控件获取此变量。 |
| --usetable | 表中的元素 | 可选 | BOOLEAN | 启用后，将按列或行在表中搜索元素。 |
| --searchbycolumn | 按列搜索 | 可选 | BOOLEAN | 启用后，将按列而不是行搜索元素。 |
| --searchcolumn | 列 | 仅当“表中的元素”为 True 时 | 文本 | 从中获取元素的列的名称或编号。 |
| --searchvalue | 值 | 仅当“按列搜索”为 True 时 | 文本 | 用于在表中查找元素的值。 |
| --returncolumn | 返回列 | 仅当“按列搜索”为 True 时 | 文本 | 包含控件的列。 |
| --row | 行 | 仅当“按列搜索”为 False 时 | 成员 | 从中获取元素的表行。 |
| --timeout | Timeout | 可选 | 时间范围、数字、文本 | 执行命令的最长时间限制。如果没有为超时参数定义任何值，那么执行将使用设置超时命令所定义的上下文超时。 如果脚本中未使用该命令，那么缺省超时为 5 秒。 |
输出
| 脚本 | 设计器 | AcceptedTypes | Description |
|---|---|---|---|
| 值 | 值 | 成员 | 返回偏移后跟踪条的值。 |
示例
使用使值偏移命令将指定的跟踪条增加 20 个单位。
defVar --name modifiedValue --type Numeric
// Open the program with the trackbar.
// Download the following application to execute the command.
launchWindow --executablepath "CSharpTestApp.exe"
// Shifts the trackbar by 20.
offsetValue --modifyby 20 --selector "Id" --id trackBar1 modifiedValue=value
logMessage --message "${modifiedValue}" --type "Info"
// Returns the number with the number of units the track bar was offset.
// 20
要正确操作以上脚本，必须下载该应用程序并在命令启动并附加窗口的参数可执行文件中插入其路径。
备注
要使用 Offset Value 命令，需要使用 IBM RPA Studio的记录器来查找跟踪栏并对其进行映射。
可以使用 IBM RPA Studio的记录器来获取以下信息: