pyautogui 文档：键盘控制

Posted 2021-11-02 gexbooks

typewrite（）函数

主要的键盘功能是typewrite()。此函数将键入字符串中传递的字符。要在按下每个字符键之间添加延迟间隔，请为interval关键字参数传递int float 。

>>> pyautogui.typewrite(‘Hello world!‘)               
>>> pyautogui.typewrite(‘Hello world!‘, interval=0.25)  

您只能按下单字符键typewrite()，因此您无法按Shift或F1键。

press（），keyDown（）和keyUp（）函数

要按下这些键，调用press()函数，从它传递一个字符串pyautogui.KEYBOARD_KEYS，例如enter，esc，f1。

>>> pyautogui.press(‘enter‘)

 

该press()功能实际上只是一个包装keyDown()和keyUp()功能，模拟按下一个键按下，然后释放它。这些功能可以自己调用。例如，要在按住Shift键的同时按下左箭头键三次，请调用以下内容：

>>> pyautogui.keyDown(‘shift‘)  # hold down the shift key
>>> pyautogui.press(‘left‘)     # press the left arrow key
>>> pyautogui.press(‘left‘)     # press the left arrow key
>>> pyautogui.press(‘left‘)     # press the left arrow key
>>> pyautogui.keyUp(‘shift‘)    # release the shift key

要按下类似于多个键的键typewrite()，请将字符串列表传递给press()。例如：

>>> pyautogui.press([‘left‘, ‘left‘, ‘left‘])

hotkey（）函数

为了使按键热键或键盘快捷键方便，hotkey()可以传递几个按键顺序按下的键，然后以相反的顺序释放。这段代码：

>>> pyautogui.hotkey(‘ctrl‘, ‘shift‘, ‘esc‘)

......相当于这段代码：

>>> pyautogui.keyDown(‘ctrl‘)
>>> pyautogui.keyDown(‘shift‘)
>>> pyautogui.keyDown(‘esc‘)
>>> pyautogui.keyUp(‘esc‘)
>>> pyautogui.keyUp(‘shift‘)
>>> pyautogui.keyUp(‘ctrl‘)

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‘]

 

资料：https://pyautogui.readthedocs.io/en/latest/keyboard.html