PyAutoGui是一个跨平台GUI自动化库。

PyAutoGUI是一个Python模块，用于以编程方式控制鼠标和键盘。

PyPutoGUI可以从pip工具安装或从PyPI下载：

https：//pypi.python.org/pypi/PyAutoGUI

源代码可在以下网址获得：https：
//github.com/asweigart/pyautogui

--------------------------------------------------------------------

这是使用PyAutoGUI的快速入门参考。 PyAutoGUI是可在Python 2和3上运行的跨平台GUI自动化模块。您可以通过PyAutuoGUI控制鼠标和键盘以及执行基本图像识别以自动执行计算机上的任务。

此页面示例中的所有关键字参数都是可选的

 

PyAutoGUI 工作于 Windows/Mac/Linux and on Python 2 & 3. 来自于 PyPI with pip install pyautogui.

General Functions

一般功能

 

Fail-Safes

失效保护

在每次PyAutoGUI调用后设置2.5秒的暂停：

 

当故障安全模式为True时，将鼠标移动到左上角将引发
pyautogui.FailSafeException

可以中止你的程序：

 

Mouse Functions

鼠标功能

XY坐标在屏幕的左上角为0,0原点。 X向右增加，Y向下增加。

 

如果duration参数设置为0或未指定，则立即移动。 注意：在Mac上拖动不能立即。

 

click（）函数默认代表鼠标当前位置的左键单击鼠标一次，但关键字参数可以通过参数设置

 

button关键字参数可以是“left”，“middle”或“right”。代表点击“左键“”中键“”右键“所有的鼠标点击都可以用 Click()设置，但是为了方便易于使用，常用点击函数有以下可选：

 

滚动向上是正向滚动，向下滚动是负向滚动：

 

可以独立调用鼠标的按下和放开时间

 

Keyboard Functions

键盘功能

模拟光标位置按键输入

 

也可以传入一些关键命令字列表，包括回车和空格

 

键盘的功能关键字列表定义在 pyAutogui.KEYBOARD_KEYS中。

>>> print(pyautogui.KEYBOARD_KEYS)

['\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']

>>

键盘热键如Ctrl-S or Ctrl-Shift-1 可以作为参数被 传递给hotkey():

 

可以单独调用单个键盘键的向下和向上事件：

 

Message Box Functions

消息框功能

如果您需要暂停程序直到用户单击“确定”，或者想要向用户显示某些信息，则消息框函数和JavaScript的函数名称类似：

 

Pyautuogui.alert调用效果

 

pyautogui.confirm调用效果

 

pyautogui.prompt 运行效果

 

如果用户单击“取消”，则prompt（）函数将返回None。

Screenshot Functions

截图功能

PyAutoGUI使用Pillow / PIL作为其图像数据操作基础库

在Linux上，您必须运行sudo apt-get install scrot才能使用屏幕截图功能。

 

如果你想点击屏幕上的某个图像，可以使用locateOnScreen（）在屏幕上找到它。

 

The locateAllOnScreen() function 返回所有的图片位置信

 

 

locateCenterOnScreen（）函数只返回在屏幕上找到图像的中间的XY坐标：

 

如果在屏幕上找不到图像，这些函数将返回None。 注意：定位功能很慢，可能需要一两秒钟。