桌面程序控制-键盘输入

键盘输入

桌面程序控制 / 键盘输入 类动作。

键盘输入

keyboard_action

桌面程序控制键盘输入

用途:执行键盘按下、按住或释放。

写法:键盘输入 按键=<按键> [模式=<模式>] [窗口句柄=<窗口句柄>]

保存为

默认保存主结果,通常就是 执行结果 这个字段。

正确示例

键盘输入 按键='ctrl+c'

# 说明:默认按下并松开组合键

错误示例

键盘输入 模式="示例值"

为什么错:漏写了必填参数:按键。

展开查看参数和注意事项
中文参数英文参数用途必填默认值
按键keys要发送的键盘按键或组合键,例如 ctrl+v、shift、enter。
模式mode支持 press/hold/release 或 按下/按住/释放。press
窗口句柄hwnd可选;显式指定窗口句柄时优先激活该窗口,不传时回退到上下文窗口。

返回结果

如果你要整份返回对象,而不只是主结果,可在行尾写 返回结果=变量名

返回结果

保存后通常可按字段路径继续读取。

字段路径类型必有说明
执行结果string未提供说明
目标类型string未提供说明
目标内容string未提供说明
窗口句柄integer | null未提供说明
模式string未提供说明

返回/保存方式:普通动作需要留给后续步骤时,通常可在行尾追加 保存为=变量名,默认保存主结果字段 执行结果。

输入文本

input_text

桌面程序控制键盘输入

用途:通过剪贴板快速输入文本。

写法:输入文本 文本内容=<文本内容> [窗口句柄=<窗口句柄>]

保存为

默认保存主结果,通常就是 执行结果 这个字段。

正确示例

输入文本 文本内容="你好,世界"

# 说明:把文本输入到当前窗口

错误示例

输入文本 窗口句柄=123456

为什么错:漏写了必填参数:文本内容。

展开查看参数和注意事项
中文参数英文参数用途必填默认值
文本内容content未提供说明
窗口句柄hwnd可选;显式指定窗口句柄时优先激活该窗口,不传时回退到上下文窗口。

返回结果

如果你要整份返回对象,而不只是主结果,可在行尾写 返回结果=变量名

返回结果

保存后通常可按字段路径继续读取。

字段路径类型必有说明
执行结果string未提供说明
目标类型string未提供说明
目标内容string未提供说明
窗口句柄integer | null未提供说明
输入方式string未提供说明

返回/保存方式:普通动作需要留给后续步骤时,通常可在行尾追加 保存为=变量名,默认保存主结果字段 执行结果。

读取剪贴板

read_clipboard

桌面程序控制键盘输入

用途:读取系统剪贴板中的文本内容。

写法:读取剪贴板

保存为

默认保存主结果,通常就是 剪贴板内容 这个字段。

正确示例

读取剪贴板

错误示例

读取剪贴板 错误参数=1

为什么错:使用了不在真实参数表里的参数名。

展开查看参数和注意事项

这个命令没有参数。

返回结果

如果你要整份返回对象,而不只是主结果,可在行尾写 返回结果=变量名

返回结果

保存后通常可按字段路径继续读取。

字段路径类型必有说明
剪贴板内容string未提供说明

返回/保存方式:普通动作需要留给后续步骤时,通常可在行尾追加 保存为=变量名,默认保存主结果字段 剪贴板内容。

复制到剪贴板

copy_to_clipboard

桌面程序控制键盘输入

用途:把内容复制到系统剪贴板。

写法:复制到剪贴板 内容=<内容>

保存为

这个动作成功时没有可复用返回值,一般不需要写 保存为=变量名返回结果=变量名

正确示例

复制到剪贴板 内容="示例内容"

错误示例

复制到剪贴板

为什么错:漏写了必填参数:内容。

展开查看参数和注意事项
中文参数英文参数用途必填默认值
内容content未提供说明

返回结果

保存后通常可按字段路径继续读取。

当前没有单独声明返回字段。

返回/保存方式:这个动作成功时没有可复用返回值,一般不需要写 保存为=变量名 或 返回结果=变量名。

清空剪贴板

clear_clipboard

桌面程序控制键盘输入

用途:清空系统剪贴板中的文本内容。

写法:清空剪贴板

保存为

这个动作成功时没有可复用返回值,一般不需要写 保存为=变量名返回结果=变量名

正确示例

清空剪贴板

# 说明:清空系统剪贴板中的文本内容

错误示例

清空剪贴板 错误参数=1

为什么错:使用了不在真实参数表里的参数名。

展开查看参数和注意事项

这个命令没有参数。

返回结果

保存后通常可按字段路径继续读取。

当前没有单独声明返回字段。

返回/保存方式:这个动作成功时没有可复用返回值,一般不需要写 保存为=变量名 或 返回结果=变量名。

获取按键状态

get_key_state

桌面程序控制键盘输入

用途:读取指定按键或最近一次物理键盘按键状态,不包含脚本或 SendInput 模拟输入。

写法:获取按键状态 [按键=<按键>]

保存为

默认保存主结果,通常就是 状态 这个字段。

正确示例

获取按键状态 按键=F8 保存为=F8状态

# 说明:查询物理 F8 是否刚刚按下。

错误示例

获取按键状态 按键="示例值" 错误参数=1

为什么错:使用了不在当前参数表里的参数名。

展开查看参数和注意事项
中文参数英文参数用途必填默认值
按键key可选;支持现有键盘输入动作支持的按键名称。不传时返回最近一次物理按键。

返回结果

如果你要整份返回对象,而不只是主结果,可在行尾写 返回结果=变量名

返回结果

保存后通常可按字段路径继续读取。

字段路径类型必有说明
状态object未提供说明
状态.按键string未提供说明
状态.是否按下boolean未提供说明
状态.状态string未提供说明
状态.刚刚按下boolean未提供说明
状态.刚刚释放boolean未提供说明
状态.来源string未提供说明

返回/保存方式:普通动作需要留给后续步骤时,通常可在行尾追加 保存为=变量名,默认保存主结果字段 状态。