获取选中的文本

获取当前窗口里选中的文字。同一个动作也可以在开启选项后，改用动作参数作为结果。

当前模块定义

sys:getSelectedText基础Action

标准模块

输入 7 · 输出 5 · 枚举 1

输入参数

文本数据格式formatEnum必填
需要读取的剪贴板文本内容格式。通常请使用Unicode纯文本格式。
填写固定输入默认 UnicodeText
4 个选项纯文本（默认）、Rtf、Html
纯文本（默认）默认UnicodeText
RtfRtf
HtmlHtml
逗号分隔的值（csv）CommaSeparatedValue
等待剪贴板时间waitMsInteger可选
模拟复制键后，等待剪贴板变化的最长时间毫秒数。
填写输入或变量默认 250
重试次数repeatInteger可选
【已过时，仅为兼容性保留】失败后重试的次数。
填写固定输入默认 0
尝试不通过剪贴板的方式获取tryNoClipboardBoolean可选
通过UIAutomation方式获取（某些情况可能出现无法完整获取文字、失去换行信息等问题）
填写固定输入默认 false
如果为动作传递了参数，使用参数值作为获取的结果useActionParamBoolean可选
没有传递参数时仍尝试获取选中的文本。
填写固定输入默认 false
去除前后的空白trimBoolean可选
去除内容前后的空白（包括空行）。
填写固定输入默认 false
失败后中止动作stopIfFailBoolean可选
获取选中的文本失败后，是否停止后续动作的执行。
填写固定输入默认 true

输出参数

是否成功isSuccessBoolean
是否成功获取了文本
内容outputText
将获得的文本写入到变量
去除封装的HTMLcleanHtmlText
剪贴板HTML的主要内容和之间的部分
条件仅：Html
URL编码的内容outputEncodedText
对选中的内容进行URL编码处理后的结果，通常用于拼接网址。
来源网址urlText
从网页中复制内容时，可能会携带网址信息。

概述

默认向当前窗口发送 Ctrl+C，等剪贴板变化后再读取内容。也可以勾选 尝试不通过剪贴板的方式获取，改用 UI Automation（不改写剪贴板，但兼容性较差）。

获取选中的文本=> {text}

输入参数

文本数据格式：从剪贴板读取哪一种格式。剪贴板里可能同时存有多种格式。

纯文本（默认）
Rtf
Html
逗号分隔的值（csv）

等待剪贴板时间：模拟 Ctrl+C 后，等待目标软件写入剪贴板的最长时间（毫秒）。默认 250。PDF 等软件或选区很大时，需要加大。

去除前后的空白：去掉结果两端的空白（包括空行）。

失败后中止动作：获取失败时是否停止后续步骤。默认开启。

重试次数：已过时，仅为兼容旧动作保留。新动作不必改这项。

不通过剪贴板获取

尝试不通过剪贴板的方式获取：用 UI Automation 读取选区，不会污染剪贴板。已知限制：

Word 里选中多个单元格时，往往拿不全
Chrome 里有的位置会丢掉换行

使用动作参数

如果为动作传递了参数，使用参数值作为获取的结果：动作参数非空时直接把它当作结果，不再去读选区；参数为空时仍按上面的方式获取选中文本。适合同一个动作既处理选中文字，又接受搜索框或其它调用传入的内容。说明见为动作传递参数。

输出参数

内容：获取到的文本。

URL 编码的内容：对内容做 URL 编码后的结果，便于拼进网址。

来源网址：从网页复制时，有时能带上页面地址。

是否成功：是否成功拿到文本。

去除封装的 HTML：仅当 文本数据格式 为 Html 时出现。剪贴板 HTML 里  与  之间的部分。

限制与排障

目标窗口要有焦点，并且支持 Ctrl+C 复制。部分网页（如百度文库）会禁止复制。
不要让安全软件拦截 Quicker 发送的按键。
默认靠剪贴板，可能覆盖用户原来的剪贴板内容；需要避免时再开 尝试不通过剪贴板的方式获取。
失败时步骤返回「获取选中文本失败了。请确认目标位置具有焦点并支持Ctrl+C复制。」
更多失败原因见旧版说明：无法获取选中的文本。

更改历史

1.5.7 增加 URL 编码结果输出。
1.8.0 增加读取动作参数。
1.38.21 增加不通过剪贴板的获取方式。

更新于 2023年6月17日

当前模块定义​

输入参数

输出参数

概述​