25-键名
20.10.2 键名
不是所有的键都很容易用单个文本字符来表示。例如,如何把Shift键或左箭头键表示为单个字符?在PyAutoGUI中,这些键表示为短的字符串值: 'esc' 表示Esc键, 'enter' 表示Enter键。
除了单个字符串参数,还可以向 write() 函数传递这些键字符串的列表。例如,以下的调用表示按a键,然后是b键,然后是左箭头两次,最后是X和Y键:
>>> pyautogui.write(['a', 'b', 'left', 'left', 'X', 'Y'])
因为按下左箭头将移动键盘光标,所以这会输出XYab。表20-1列出了PyAutoGUI的键盘按键字符串及其含义,你可以将它们传递给 write() 函数,模拟任何按键组合。
你也可以查看 pyautogui.KEYBOARD_KEYS 列表,看看PyAutoGUI接收的所有可能的键字符串。 'shift' 字符串指的是左边的Shift键,它等价于 'shiftleft' 。 'ctrl' 、 'alt' 和 'win' 字符串也一样,它们都是指左边的键。
| 键盘按键字符串 | 含义 |
| :----- | :----- | :----- | :----- |
| 'a' 、 'b' 、 'c' 、 'A' 、 'B' 、 'C' 、 '1' 、 '2' 、 '3' 、 '!' 、 '@' 、 '#' 等 | 单个字符的键 |
| 'enter' ( or 'return' or '\n' ) | 回车键 |
| 'esc' | Esc键 |
| 'shiftleft' 、 'shiftright' | 左右Shift键 |
| 'altleft' 、 'altright' | 左右Alt键 |
| 'ctrlleft' 、 'ctrlright' | 左右Ctrl键 |
| 'tab' ( or '\t' ) | Tab键 |
| 'backspace' 、 'delete' | Backspace键和Delete键 |
| 'pageup' 、 'pagedown' | Page Up键和Page Down键 |
| 'home' 、 'end' | Home键和End键 |
| 'up' 、 'down' 、 'left' 、 'right' | 上下左右箭头键 |
| 'f1' 、 'f2' 、 'f3' 等 | F1~F12键 |
| 'volumemute' 、 'volumedown' 、 'volumeup' | 静音、减小音量、放大音量键(有些键盘没有这些键,但你的操作系统仍能理解这些模拟的按键) |
| 'pause' | Pause键 |
| 'capslock' 、 'numlock' 、 'scrolllock' | Caps Lock键、Num lock键和Scroll Lock键 |
| 'insert' | Ins键或Insert键 |
| 'printscreen' | Prtsc键或Print Screen键 |
| 'winleft' 、 'winright' | 左右Win键(在Windows操作系统上) |
| 'command' | Command键(在macOS上) |
| 'option' | Option键(在macOS上) |