输入与键盘

keys()、enter()、input(ctrl=…) 里的 ctrl 都是 UIA 控件对象，需先用 find() 或 wait_ctrl() 拿到，再传给后续方法：

# ① 先获取控件（下面所有 ctrl=ctrl 都指这个变量）
ctrl = auto.find(ctrl_type='EditControl', aid='chat_input')

# 若控件可能尚未出现，可轮询等待：
# ctrl = auto.wait_ctrl(ctrl_type='EditControl', aid='chat_input', timeout=5.0)

# ② 输入文字
auto.input('你好', ctrl=ctrl, paste=True)              # 默认 paste=True，走剪贴板
auto.input('你好', ctrl=ctrl, paste=False)             # uia 模式可尝试 ctrl.Input
auto.input('你好', ctrl_type='EditControl', aid='chat_input')  # 或不先 find，直接传属性

# 快捷：点击 + 输入 + 回车
auto.send_msg('你好', aid='chat_input')
auto.clear_input(ctrl=ctrl)                            # 内部 hotkey Ctrl+A + Delete

# ③ 按键
# 组合键 → hotkey（post/auto 常用，需 hwnd）
auto.hotkey(0x11, 0x41)                  # Ctrl+A
auto.hotkey(0x11, 0x43)                  # Ctrl+C

# 复杂键序列 → keys + ctrl（UIA SendKeys，mode='uia' 或 auto 有 ctrl 时）
auto.keys('{Ctrl}a{Delete}', ctrl)       # 全选后删除（需 ctrl，post 模式不可用）
auto.keys('{Enter}', ctrl)               # 单键也可传 ctrl

# 单功能键 → keys 或 enter（post 模式仅支持 _VK_MAP 中的单键）
auto.enter(ctrl)                         # 等同 keys('{Enter}', ctrl)
auto.keys('{PageDown}', ctrl)

键盘两种方式对比：

方法	写法示例	`ctrl`	组合键
`hotkey(vk1, vk2, …)`	`auto.hotkey(0x11, 0x41)`	不需要	post/auto 推荐
`keys(str, ctrl)`	`auto.keys('{Ctrl}a', ctrl)`	组合键建议必传	uia/auto + ctrl
`enter(ctrl)`	`auto.enter(ctrl)`	可选	单键 Enter

keys() 在 post/mouse 下仅支持下列单键字面量（与 _VK_MAP 一致）：{Enter} {Esc} {Tab} {PageUp} {PageDown} {Home} {End} {Up} {Down} {Left} {Right} {Delete} {BackSpace} {Space} {Insert} {F1}–{F8}。

常用 VK 码速查

修饰键：

键	VK	键	VK
Ctrl	`0x11`	Shift	`0x10`
Alt	`0x12`	Win	`0x5B`

功能键（hotkey 组合用 VK；keys 在 post 模式仅支持下列单键字面量）：

键	VK	键	VK
Enter	`0x0D`	Esc	`0x1B`
Tab	`0x09`	Space	`0x20`
Backspace	`0x08`	Delete	`0x2E`
Insert	`0x2D`	Home	`0x24`
End	`0x23`	PageUp	`0x21`
PageDown	`0x22`	↑↓←→	`0x26/0x28/0x25/0x27`
F1–F8	`0x70`–`0x77`

字母与数字（hotkey 用 VK；规律：A–Z = 0x41–0x5A，0–9 = 0x30–0x39）：

键	VK	键	VK	键	VK	键	VK
A	`0x41`	C	`0x43`	V	`0x56`	X	`0x58`
S	`0x53`	Z	`0x5A`	F	`0x46`	0–9	`0x30`–`0x39`

常见组合示例：

auto.hotkey(0x11, 0x41)   # Ctrl+A  全选
auto.hotkey(0x11, 0x43)   # Ctrl+C  复制
auto.hotkey(0x11, 0x56)   # Ctrl+V  粘贴
auto.hotkey(0x11, 0x58)   # Ctrl+X  剪切
auto.hotkey(0x11, 0x5A)   # Ctrl+Z  撤销
auto.hotkey(0x11, 0x53)   # Ctrl+S  保存
auto.hotkey(0x11, 0x0D)   # Ctrl+Enter

组合键优先 hotkey(0x11, 0x43) 等形式

复杂 SendKeys 字符串（含 {Ctrl}）用 keys('…', ctrl)，且需 ctrl 来自步骤 ①

paste() 内部调用 keys('{Ctrl}v', ctrl)，同样需要控件或 uia 模式

API 参考

输入与键盘

✨input

向目标控件输入文字；会先 click(ctrl) 聚焦。

auto.input('你好', ctrl=editor, mode='uia')
auto.input('abc', ctrl=editor, mode='uia', paste=False)

参数：

参数名	类型	默认值	描述
text	str	无	要输入的字符串
ctrl	Control	None	目标控件
ctrl_type	str	''	未传 `ctrl` 时用于查找
name	str	''	未传 `ctrl` 时用于查找
aid	str	''	未传 `ctrl` 时用于查找
cls	str	''	未传 `ctrl` 时用于查找
depth	int	10	搜索深度
paste	bool	True	`True`：剪贴板粘贴；`False`：UIA 尝试 `ctrl.Input()`；Post 用 WM_CHAR
mode	str	None	操作模式

返回值：

类型：WinAuto

✨keys

SendKeys 语法按键：'{Enter}'、'{Ctrl}a'、'{PageDown}' 等。

auto.keys('{Ctrl}a{Delete}', ctrl)
auto.keys('{PageDown}', ctrl)

参数：

参数名	类型	默认值	描述
keys	str	无	SendKeys 字符串
ctrl	Control	None	UIA 控件；`uia` 模式必须传
mode	str	None	操作模式

返回值：

类型：WinAuto

说明：

模式	要求
`uia`	必须传 `ctrl`
`post`	组合键走 `_post_combo`（需 `ctrl` 的 NativeWindowHandle）；单键走 `_VK_MAP`
`mouse`	物理按键

不支持时抛 RuntimeError。

✨hotkey

虚拟键码组合键，如 Ctrl+A。

auto.hotkey(0x11, 0x41)

参数：

参数名	类型	默认值	描述
*vk_codes	int	无	虚拟键码，如 `0x11, 0x41`（Ctrl+A）
mode	str	None	操作模式
ctrl	Control	None	Post 模式定位编辑框句柄

返回值：

类型：WinAuto

说明：

UIA 模式不支持，请用 keys('{Ctrl}a', ctrl)。

✨enter

等同 keys('{Enter}', ctrl, mode=mode)。

auto.enter(ctrl)

参数：

参数名	类型	默认值	描述
ctrl	Control	None	UIA 控件
mode	str	None	操作模式

返回值：

类型：WinAuto

✨send_msg

click → input → enter 一步发送消息。

auto.send_msg('你好', aid='chat_input')

参数：

参数名	类型	默认值	描述
text	str	无	要发送的文字
ctrl	Control	None	输入框控件
ctrl_type	str	''	未传 `ctrl` 时用于查找
name	str	''	未传 `ctrl` 时用于查找
aid	str	''	未传 `ctrl` 时用于查找
cls	str	''	未传 `ctrl` 时用于查找
depth	int	10	搜索深度
paste	bool	True	是否走剪贴板粘贴
mode	str	None	操作模式

返回值：

类型：WinAuto

✨clear_input

清空输入框：UIA 可 ValuePattern.SetValue('')；否则全选+删除。

auto.clear_input(ctrl=ctrl)

参数：

参数名	类型	默认值	描述
ctrl	Control	None	输入框控件
mode	str	None	操作模式

返回值：

类型：WinAuto

✨type_and_send

clear_input → input → enter 一步完成（清空后输入并发送）。

ctrl = auto.find(ctrl_type='EditControl', aid='chat_input', depth=12)
auto.type_and_send('你好，测试消息', ctrl, mode='uia')

参数：

参数名	类型	默认值	描述
text	str	无	要发送的文字
ctrl	Control	None	输入框控件
mode	str	None	操作模式
paste	bool	True	输入是否走剪贴板

返回值：

类型：WinAuto

✨select_all

全选输入框内容。

auto.select_all(ctrl=ctrl, mode='uia')

参数：

参数名	类型	默认值	描述
ctrl	Control	None	输入框控件
mode	str	None	操作模式

返回值：

类型：WinAuto

说明：

模式	路径
`uia`	TextPattern 全选或 SendKeys `{Ctrl}a`
`post`	EM_SETSEL / PostMessage Ctrl+A（仅标准 Edit 或支持 WM_KEY 的控件）
其它	`keys('{Ctrl}a', ...)`

#输入与键盘

#输入与键盘

#API 参考

#输入与键盘

#✨input

#✨keys

#✨hotkey

#✨enter

#✨send_msg

#✨clear_input

#✨type_and_send

#✨select_all

输入与键盘

输入与键盘

API 参考

输入与键盘

✨input

✨keys

✨hotkey

✨enter

✨send_msg

✨clear_input

✨type_and_send

✨select_all