PyAutoGUI图形用户界面自动化的超详细教程_Python

开始之前

在开始之前，要先安装所需要的模块 pyautogui， pyautogui 模块可以向 Windows 发送虚拟按键和鼠标点击。

pip install -i https://pypi.douban.com/simple pyautogui

查看屏幕大小

PyAutoGUI图形用户界面自动化的超详细教程

pyautogui.size() 可以获得屏幕的宽和高的像素数（整数）。

>>> pyautogui.size()
Size(width=1920, height=1080)
# 也可以直接将宽，高进行保存 x, y = pyautogui.size()

获取当前鼠标的位置

函数返回当前位置 X，Y 坐标的元组，如果设置 x，y 的参数，则会覆盖返回结果。

>>> pyautogui.position(x=None, y=None)
Point(x=1437, y=817)

检查指定坐标是否在屏幕上

要检查 X，Y 坐标是否在屏幕上，将它们(支持两个整数，列表，元组)传递给 onScreen() 函数，如果它们在屏幕的边界内，则返回 True ，否则返回 False 。

>>> pyautogui.size()
(1920, 1080)
>>> pyautogui.onScreen(1920, 1080)
False
>>> pyautogui.onScreen(1919, 1079)
True

设置暂停时间

使用 pyautogui.PAUSE 变量设置要暂停的秒数。如，在设置 pyautogui.PAUSE = 1 之后，每个 PyAutoGUI 函数调用在执行动作之后，都会等待一秒。

>>> pyautogui.PAUSE = 1

鼠标功能

移动鼠标

移动鼠标到指定位置。

pyautogui.moveTo(x=None, y=None, duration=0.0) # 移动鼠标到指定位置
pyautogui.move(xOffset=None, yOffset=None, duration=0.0) # 在PyAutoGUI 1.0，move 替换了 moveRel，但moveRel也可以使用

pyautogui.moveTo(200, 300, duration=0.5)   # 移动到坐标（200，300）
pyautogui.move(200, 300, duration=0.5)     # 从当前鼠标位置向右移动 200 向下移动 300

主要参数参数：

x/xOffset：X轴坐标，moveTo() 中取值0或正整数值，move()/moveRel() 中取值可以为负数，代表以当前位置向左移动

y/yOffset：Y轴坐标，moveTo() 中取值0或正整数值，move()/moveRel() 中取值可以为负数，代表以当前位置向上移动

duration：移动到指定坐标花费的时间，默认为0，代表立即完成，单位为s

鼠标点击

使用 click() 完成鼠标点击操作。

>>> pyautogui.click(x=None, y=None, clicks=1, interval=0.0, button=PRIMARY, duration=0.0)

主要参数：

x：X轴坐标，默认为 None，即当前X轴坐标

y：Y轴坐标，默认为 None，即当前Y轴坐标（注：X，Y 轴的坐标只能同时指定，不能只指定某一个）

clicks：鼠标的点击次数，默认为 1 次

interval：int 或浮点数，表示每次单击之间需要等待多少秒，默认值为0.0，表示单击之间没有暂停

button：可选 LEFT、MIDDLE、RIGHT、PRIMARY（左键）或 SECONDARY（右键）。它的默认值是 PRIMARY

duration：如果指定了 X，Y 的值，并且该坐标不是鼠标当前位置的话，那么 duration 参数就可以生效，它表示移动到指定坐标花费的时间，默认为 0，表示立即移动。

其他点击操作：

pyautogui.mouseDown()    # 按下鼠标按键（左键）
pyautogui.mouseUp()      # 释放鼠标按键（左键）

鼠标拖动

按住鼠标的某个键进行拖动。

pyautogui.dragTo(x=None, y=None, duration=0.0, button=PRIMARY)     # 将鼠标拖动到指定位置  

pyautogui.drag(xOffset=0, yOffset=0, duration=0.0, button=PRIMARY)    # 将鼠标拖动到屏幕上相对于当前位置的一个点。

主要参数：

x，y/xOffset，yOffset：x 和 y 指明鼠标事件发生的位置。如果为 None，则使用鼠标当前位置。如果是浮点值，则将其舍入。如果在屏幕边界之外，则事件发生在屏幕边缘。

duration：如果指定了 X，Y 的值，并且该坐标不是鼠标当前位置的话，那么 duration 参数就可以生效，它表示移动到指定坐标花费的时间，默认为 0，表示立即移动。

button：可选 LEFT、MIDDLE、RIGHT、PRIMARY（左键）或 SECONDARY（右键）。它的默认值是 PRIMARY

示例：

PyAutoGUI图形用户界面自动化的超详细教程

鼠标滚动

垂直滚动，在不同平台滚动的效果可能不一样。

>>> pyautogui.scroll(100)   # 向上滚动100
>>> pyautogui.scroll(-100)  # 向下滚动100
>>> pyautogui.scroll(100, x=200, y=200)  # 移动到200， 然后执行滚动

水平滚动，（适用与 OS X 和 Linux 平台上）。

>>> pyautogui.hscroll(100)   # 向右滚动100
>>> pyautogui.hscroll(-100)   # 向左滚动100

示例：

PyAutoGUI图形用户界面自动化的超详细教程

屏幕功能

截屏功能

使用 screenshot() 函数来实现截屏功能。调用 screenshot() 将返回一个 Image 对象。传入一个文件名字符串将把截图保存到文件中，并将其作为一个 Image 对象返回。通过 region 关键字参数来捕获指定区域，只需传递一个由 left, top, width, height 组成的元组（left，top为左上角坐标）。

>>> import pyautogui
>>> pyautogui.screenshot()
>>> pyautogui.screenshot(r'C:\Users\pc\Desktop\test.png')
>>> pyautogui.screenshot(r'C:\Users\pc\Desktop\test.png', region=(300, 300, 500, 1000))

定位功能

如果不知道要点击的内容在屏幕上的确切坐标，就不能调用 moveTo() 和 click() 函数。但是，如果有按钮的图像，如下面这个图片，那就可以调用 locateOnScreen('图片路径') 函数来获取坐标。返回值是一个元组:(left, top, width, height)。这个元组可以传递给 center() 来获得该区域中心的坐标（X，Y）。如果在屏幕上找不到图像，locateOnScreen() 将引发 ImageNotFoundException 异常。

>>> location = pyautogui.locateOnScreen('图片路径')
>>> pyautogui.center(location)

还可以将 grayscale=True 传递给 locateOnScreen，以略微加速(大约 30%)。这降低了图像和截图的颜色饱和度，加快了定位速度，但可能会导致错误匹配。

消息框功能

PyAutoGUI 利用 PyMsgBox 中的消息框函数提供了一种跨平台的纯 Python 方法来显示 javascript 样式的消息框。

alert()函数

>>> pyautogui.alert(text='text', src="/uploads/allimg/221130/10420R917-3.png" />

confirm()函数

显示带有多个按钮的消息框。按钮的数量和文字可以自己设置。单击按钮返回该按钮的文本。

>>> pyautogui.confirm(text='text', src="/uploads/allimg/221130/10420WX2-4.png" />

prompt()函数

显示一个包含确认，取消按钮和文本输入栏的消息框，用户可以输入指定内容。当点击确认按钮后，返回输入框中的值；若点击取消，则返回 None 。

pyautogui.prompt(text='text', src="/uploads/allimg/221130/10420V138-5.png" />

password()函数

显示一个包含确认，取消按钮和文本输入栏的消息框，输入的字符显示为"*"。如果点击确认则返回输入的文本；如果单击“取消”，则为 None 。

pyautogui.password(text='text', src="/uploads/allimg/221130/10420Ta9-6.png" />

键盘控制功能

write()函数

write() 函数将在传入的字符串中键入字符。若要在按下每个字符键之间添加延迟间隔，interval 参数可以设置每个按键之间添加延迟。

>>> pyautogui.write('Hello world!', interval=0.25) # 每个字符间隔0.25秒

注意：pyautogui 并不支持输入框自动聚焦，所有输入之前先要点击输入框位置。

press()函数

press() 函数执行的操作相当于鼠标操作的 click()，它接收传递给它的字符串。

press('num0', presses=1, interval=0.0)

keys：传入的键盘字符串
presses：操作按键次数，默认一次
interval：每次按键的间隔时间，默认0

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

hotkey()函数

接收多个字符串参数，顺序按下，再按相反的顺序释放。

pyautogui.hotkey('ctrl', 'shift', 'esc')

相当于
pyautogui.keyDown('ctrl')    # 按下 ctrl 
pyautogui.keyDown('shift')    # 按下 shift
pyautogui.keyDown('esc')    # 按下 esc
pyautogui.keyUp('esc')    # 释放 ctrl 
pyautogui.keyUp('shift')    # 释放 shift
pyautogui.keyUp('ctrl') # 释放 esc

示例：

PyAutoGUI图形用户界面自动化的超详细教程