跳到主要内容

TextWin

非等待文本窗口句柄(qk.Ui.OpenText 返回):仅本次运行有效,不能返回或写入 State;窗口本身在运行结束后保留,由用户关闭。窗口关闭后 Append/SetText/Activate/Close 不做任何事(用 Closed 判断)。停止后的 finally 中仍可对它调用 Close/Append/SetText(清理阶段合计最多 64K 字符);读取 Closed 不需要能力,任何时候都可用。

属性​

属性类型说明
Closedbool窗口是否已关闭(用户关闭、点 operations 按钮、调用 Close、被同 Key 窗口替换)。

TextWin.Append​

void Append(string text)

在末尾追加文本(光标移到末尾);窗口内容最多 4M 字符。

参数声明说明
string text见本成员和所在域的说明。

返回类型:void。空值、用户取消和异常行为以成员及域说明为准。

基础能力:无基础能力授权要求。某些参数或数据来源会追加能力,详见安全与授权。

TextWin.SetText​

void SetText(string text)

替换全部文本(光标移到开头)。

参数声明说明
string text见本成员和所在域的说明。

返回类型:void。空值、用户取消和异常行为以成员及域说明为准。

基础能力:无基础能力授权要求。某些参数或数据来源会追加能力,详见安全与授权。

TextWin.Activate​

void Activate()

显示并激活窗口(最小化时还原)。

返回类型:void。空值、用户取消和异常行为以成员及域说明为准。

基础能力:无基础能力授权要求。某些参数或数据来源会追加能力,详见安全与授权。

TextWin.WaitForClose​

TextResult? WaitForClose()

等待用户关闭窗口(点 X、Esc、失焦关闭或点击 operations 按钮——点击 operations 按钮即关闭窗口),返回关闭时的文本、选中内容、光标与 Operation(点击的 operations 值,否则 null);被 Close 关闭、被同 options.Key 的 OpenText 替换或运行结束时返回 null;运行被停止时中断等待。

返回类型:TextResult?。空值、用户取消和异常行为以成员及域说明为准。

基础能力:无基础能力授权要求。某些参数或数据来源会追加能力,详见安全与授权。

TextWin.Close​

void Close()

关闭窗口(之后 WaitForClose 返回 null);已关闭时无操作。

返回类型:void。空值、用户取消和异常行为以成员及域说明为准。

基础能力:无基础能力授权要求。某些参数或数据来源会追加能力,详见安全与授权。