PyAutoGui 键盘控制函数

键盘控制函数

write() 函数

最核心的键盘功能函数是 write()。该函数将输入所传递字符串中的字符。若要在每次按键之间添加延迟间隔,可通过 interval 命名参数传入整数或浮点数。

示例:

python 复制代码
>>> pyautogui.write('Hello world!')                 # 立即输出"Hello world!"
>>> pyautogui.write('Hello world!', interval=0.25)  # 输出"Hello world!",每个字符输入后延迟0.25秒

write() 函数仅支持输入单字符按键,因此无法处理 Shift 或 F1 等功能键。

press()、keyDown() 和 keyUp() 函数

要按下这类功能键,可调用 press() 函数,并传入 pyautogui.KEYBOARD_KEYS 中的字符串参数,例如 enterescf1。具体请参阅 KEYBOARD_KEYS

示例:

python 复制代码
>>> pyautogui.press('enter')  # 按下回车键
>>> pyautogui.press('f1')     # 按下F1键
>>> pyautogui.press('left')   # 按下左箭头键

press() 函数实质上是 keyDown()keyUp() 函数的封装,这两个函数分别模拟按下和释放按键。它们也可以独立调用。例如,要在按住 Shift 键的同时按三次左箭头键,可执行以下代码:

python 复制代码
>>> pyautogui.keyDown('shift')  # 按住Shift键
>>> pyautogui.press('left')     # 按下左箭头键
>>> pyautogui.press('left')     # 按下左箭头键
>>> pyautogui.press('left')     # 按下左箭头键
>>> pyautogui.keyUp('shift')    # 释放Shift键

要实现类似 write() 的多键输入效果,可向 press() 传入字符串列表。示例:

python 复制代码
>>> pyautogui.press(['left', 'left', 'left'])

或者可以设置 left 键的按压次数:

python 复制代码
>>> pyautogui.press('left', presses=3)

若要在每次按键之间添加延迟间隔,可通过 interval 命名参数传入整数或浮点数。

hold() 上下文管理器

为便捷实现按键长按操作,可使用 hold() 函数作为上下文管理器,传入 pyautogui.KEYBOARD_KEYS 中的字符串参数(如 shiftctrlalt),该按键将在 with 代码块执行期间保持按下状态。具体请参阅 KEYBOARD_KEYS

python 复制代码
>>> with pyautogui.hold('shift'):
        pyautogui.press(['left', 'left', 'left'])

上述代码等效于:

python 复制代码
>>> pyautogui.keyDown('shift')  # 按住Shift键
>>> pyautogui.press('left')     # 按下左箭头键
>>> pyautogui.press('left')     # 按下左箭头键
>>> pyautogui.press('left')     # 按下左箭头键
>>> pyautogui.keyUp('shift')    # 释放Shift键

hotkey() 函数

为便捷触发热键或键盘快捷键,hotkey() 函数可接收多个按键字符串参数,这些按键将按顺序按下,并按相反顺序释放。以下代码:

python 复制代码
>>> pyautogui.hotkey('ctrl', 'shift', 'esc')

等效于:

python 复制代码
>>> pyautogui.keyDown('ctrl')
>>> pyautogui.keyDown('shift')
>>> pyautogui.keyDown('esc')
>>> pyautogui.keyUp('esc')
>>> pyautogui.keyUp('shift')
>>> pyautogui.keyUp('ctrl')

若要在每次按键之间添加延迟间隔,可通过 interval 命名参数传入整数或浮点数。

KEYBOARD_KEYS

以下是可以传递给 press()keyDown()keyUp()hotkey() 函数的有效字符串参数列表:

复制代码
['\t', '\n', '\r', ' ', '!', '"', '#', '$', '%', '&', "'", '(',
')', '*', '+', ',', '-', '.', '/', '0', '1', '2', '3', '4', '5', '6', '7',
'8', '9', ':', ';', '<', '=', '>', '?', '@', '[', '\\', ']', '^', '_', '`',
'a', 'b', 'c', 'd', 'e','f', 'g', 'h', 'i', 'j', 'k', 'l', 'm', 'n', 'o',
'p', 'q', 'r', 's', 't', 'u', 'v', 'w', 'x', 'y', 'z', '{', '|', '}', '~',
'accept', 'add', 'alt', 'altleft', 'altright', 'apps', 'backspace',
'browserback', 'browserfavorites', 'browserforward', 'browserhome',
'browserrefresh', 'browsersearch', 'browserstop', 'capslock', 'clear',
'convert', 'ctrl', 'ctrlleft', 'ctrlright', 'decimal', 'del', 'delete',
'divide', 'down', 'end', 'enter', 'esc', 'escape', 'execute', 'f1', 'f10',
'f11', 'f12', 'f13', 'f14', 'f15', 'f16', 'f17', 'f18', 'f19', 'f2', 'f20',
'f21', 'f22', 'f23', 'f24', 'f3', 'f4', 'f5', 'f6', 'f7', 'f8', 'f9',
'final', 'fn', 'hanguel', 'hangul', 'hanja', 'help', 'home', 'insert', 'junja',
'kana', 'kanji', 'launchapp1', 'launchapp2', 'launchmail',
'launchmediaselect', 'left', 'modechange', 'multiply', 'nexttrack',
'nonconvert', 'num0', 'num1', 'num2', 'num3', 'num4', 'num5', 'num6',
'num7', 'num8', 'num9', 'numlock', 'pagedown', 'pageup', 'pause', 'pgdn',
'pgup', 'playpause', 'prevtrack', 'print', 'printscreen', 'prntscrn',
'prtsc', 'prtscr', 'return', 'right', 'scrolllock', 'select', 'separator',
'shift', 'shiftleft', 'shiftright', 'sleep', 'space', 'stop', 'subtract', 'tab',
'up', 'volumedown', 'volumemute', 'volumeup', 'win', 'winleft', 'winright', 'yen',
'command', 'option', 'optionleft', 'optionright']
相关推荐
AI智图坊18 小时前
多件装组合SKU图的批量生产效率分析:从PS手工到AI自动化的工作流改造
大数据·运维·人工智能·gpt·ai作画·自动化·aigc
云烟成雨TD19 小时前
Spring AI 1.x 系列【56】用大模型评判大模型:递归顾问实现自动化评估方案
人工智能·spring·自动化
qq_366566501 天前
视频配音自动化Pipeline:TTS选型+音色克隆+批量处理(附完整代码)
自动化·新媒体运营·音视频·音频
志栋智能1 天前
超自动化巡检:提升MTTR,缩短业务影响时间
运维·自动化
IvorySQL1 天前
PostgreSQL 技术日报 (6月9日)|PL/SQL 迁移自动化,前沿峰会即将启幕
sql·postgresql·自动化
Black蜡笔小新1 天前
自动化AI算法训练服务器DLTM训推一体工作站赋能多行业智能化升级
人工智能·算法·自动化
北京耐用通信1 天前
耐达讯自动化工业网关:极简组态实现 Modbus 转 PROFINET 稳定通讯
人工智能·物联网·网络协议·自动化·信息与通信
@Ma1 天前
企业微信外部群的消息自动化:从协议层到工程实践
运维·自动化·企业微信
Mr -老鬼1 天前
2026移动端自动化平台横向对比指南:15+主流平台深度评测,开发者选型必备
运维·自动化·easyclick·移动测试
会Tk矩阵群控的小木1 天前
小红书矩阵软件:基于Python+ADB的多设备批量管理自动化脚本实战
运维·python·adb·矩阵·自动化·新媒体运营·个人开发