Python中PyAutoGUI幫助文檔(推薦!)

更新時(shí)間：2022年03月23日 09:48:28 作者：qq_34053552

PyAutoGui是一個(gè)跨平臺(tái)GUI自動(dòng)化庫,PyAutoGUI是一個(gè)Python模塊,用于以編程方式控制鼠標(biāo)和鍵盤,下面這篇文章主要給大家介紹了關(guān)于Python中PyAutoGUI幫助文檔的相關(guān)資料,需要的朋友可以參考下

import pyperclip
import pyautogui
 
#  PyAutoGUI中文輸入需要用粘貼實(shí)現(xiàn)
#  Python 2版本的pyperclip提供中文復(fù)制
def paste(foo):
    pyperclip.copy(foo)
    pyautogui.hotkey('ctrl', 'v')
 
foo = u'學(xué)而時(shí)習(xí)之'
#  移動(dòng)到文本框
pyautogui.click(130,30)
paste(foo)

1.簡(jiǎn)介

1.1 目的

PyAutoGUI是一個(gè)純Python的GUI自動(dòng)化工具，其目的是可以用程序自動(dòng)控制鼠標(biāo)和鍵盤操作，多平臺(tái)支持（Windows，OS X，Linux）?？梢杂胮ip安裝，Github上有源代碼。

下面的代碼讓鼠標(biāo)移到屏幕中央。

import pyautogui
screenWidth, screenHeight = pyautogui.size()
pyautogui.moveTo(screenWidth / 2, screenHeight / 2)

PyAutoGUI可以模擬鼠標(biāo)的移動(dòng)、點(diǎn)擊、拖拽，鍵盤按鍵輸入、按住操作，以及鼠標(biāo)+鍵盤的熱鍵同時(shí)按住等操作，可以說手能動(dòng)的都可以。

1.2 例子

import pyautogui
screenWidth, screenHeight = pyautogui.size()
currentMouseX, currentMouseY = pyautogui.position()
pyautogui.moveTo(100, 150)
pyautogui.click()
#  鼠標(biāo)向下移動(dòng)10像素
pyautogui.moveRel(None, 10)
pyautogui.doubleClick()
#  用緩動(dòng)/漸變函數(shù)讓鼠標(biāo)2秒后移動(dòng)到(500,500)位置
#  use tweening/easing function to move mouse over 2 seconds.
pyautogui.moveTo(1800, 500, duration=2, tween=pyautogui.easeInOutQuad)
#  在每次輸入之間暫停0.25秒
pyautogui.typewrite('Hello world!', interval=0.25)
pyautogui.press('esc')
pyautogui.keyDown('shift')
pyautogui.press(['left', 'left', 'left', 'left', 'left', 'left'])
pyautogui.keyUp('shift')
pyautogui.hotkey('ctrl', 'c')

distance = 200
while distance > 0:
    pyautogui.dragRel(distance, 0, duration=0.5) # 向右
    distance -= 5
    pyautogui.dragRel(0, distance, duration=0.5) # 向下
    pyautogui.draIn gRel(-distance, 0, duration=0.5) # 向左
    distance -= 5
    pyautogui.dragRel(0, -distance, duration=0.5) # 向上

1.4 保護(hù)措施（Fail-Safes）

就像《魔法師的學(xué)徒》(Sorcerer’s Apprentice)會(huì)擔(dān)水的掃帚，可以擔(dān)水，卻無力阻止水漫浴室。你的程序也可能會(huì)失控（即使是按照你的意思執(zhí)行的），那時(shí)就需要中斷。如果鼠標(biāo)還在自動(dòng)操作，就很難在程序窗口關(guān)閉它。

為了能夠及時(shí)中斷，PyAutoGUI提供了一個(gè)保護(hù)措施。當(dāng)pyautogui.FAILSAFE = True時(shí)，如果把鼠標(biāo)光標(biāo)在屏幕左上角，PyAutoGUI函數(shù)就會(huì)產(chǎn)生pyautogui.FailSafeException異常。如果失控了，需要中斷PyAutoGUI函數(shù)，就把鼠標(biāo)光標(biāo)在屏幕左上角。要禁用這個(gè)特性，就把FAILSAFE設(shè)置成False：

import pyautogui
pyautogui.FAILSAFE = False

通過把pyautogui.PAUSE設(shè)置成float或int時(shí)間（秒），可以為所有的PyAutoGUI函數(shù)增加延遲。默認(rèn)延遲時(shí)間是0.1秒。在函數(shù)循環(huán)執(zhí)行的時(shí)候，這樣做可以讓PyAutoGUI運(yùn)行的慢一點(diǎn)，非常有用。例如：

import pyautogui
pyautogui.PAUSE = 2.5
pyautogui.moveTo(100,100); pyautogui.click()

所有的PyAutoGUI函數(shù)在延遲完成前都處于阻塞狀態(tài)（block）。（未來計(jì)劃增加一個(gè)可選的非阻塞模式來調(diào)用函數(shù)。）

建議PAUSE和FAILSAFE一起使用。

2 安裝與依賴

PyAutoGUI支持Python 2.x和Python 3.x

Windows：PyAutoGUI沒有任何依賴，因?yàn)樗肞ython的ctypes模塊所以不需要pywin32

pip3 install pyautogui

OS X：PyAutoGUI需要PyObjC運(yùn)行AppKit和Quartz模塊。這個(gè)模塊在PyPI上的按住順序是pyobjc-core和pyobjc

sudo pip3 install pyobjc-core
sudo pip3 install pyobjc
sudo pip3 install pyautogui

Linux：PyAutoGUI需要python-xlib（Python 2）、python3-Xlib（Python 3）

sudo pip3 install python3-xlib
sudo apt-get scrot
sudo apt-get install python-tk
sudo apt-get install python3-dev
sudo pip3 install pyautogui

3.速查表（小抄，Cheat Sheet）

3.1 常用函數(shù)

import pyautogui
#  當(dāng)前鼠標(biāo)的坐標(biāo)
pyautogui.position()
(123, 372)

#  當(dāng)前屏幕的分辨率（寬度和高度）
pyautogui.size()
(1920, 1080)

#  (x,y)是否在屏幕上
x, y = 122, 244
pyautogui.onScreen(x, y)
True

3.2 保護(hù)措施

PyAutoGUI函數(shù)增加延遲為2.5秒：

import pyautogui
pyautogui.PAUSE = 2.5

當(dāng)pyautogui.FAILSAFE = True時(shí)，如果把鼠標(biāo)光標(biāo)在屏幕左上角，PyAutoGUI函數(shù)就會(huì)產(chǎn)生pyautogui.FailSafeException異常。

import pyautogui
pyautogui.FAILSAFE = True

3.3 鼠標(biāo)函數(shù)

坐標(biāo)系的原點(diǎn)是左上角。X軸（水平）坐標(biāo)向右增大，Y軸（豎直）坐標(biāo)向下增大。

 num_seconds = 1.2
#  用num_seconds秒的時(shí)間把光標(biāo)移動(dòng)到(x, y)位置
pyautogui.moveTo(x, y, duration=num_seconds)
#  用num_seconds秒的時(shí)間把光標(biāo)的X軸（水平）坐標(biāo)移動(dòng)xOffset，
#  Y軸（豎直）坐標(biāo)向下移動(dòng)yOffset。
xOffset, yOffset = 50, 100
pyautogui.moveRel(xOffset, yOffset, duration=num_seconds)

click()函數(shù)就是讓鼠標(biāo)點(diǎn)擊，默認(rèn)是單擊左鍵，參數(shù)可以設(shè)置：

pyautogui.click(x=moveToX, y=moveToY, clicks=num_of_clicks, interval=secs_between_clicks, button='left')

其中，button屬性可以設(shè)置成left，middle和right。

所有的點(diǎn)擊都可以用這個(gè)函數(shù)，不過下面的函數(shù)可讀性更好：

yautogui.rightClick(x=moveToX, y=moveToY)
pyautogui.middleClick(x=moveToX, y=moveToY)
pyautogui.doubleClick(x=moveToX, y=moveToY)
pyautogui.tripleClick(x=moveToX, y=moveToY)

scroll函數(shù)控制鼠標(biāo)滾輪的滾動(dòng)，amount_to_scroll參數(shù)表示滾動(dòng)的格數(shù)。正數(shù)則頁面向上滾動(dòng)，負(fù)數(shù)則向下滾動(dòng)：

pyautogui.scroll(clicks=amount_to_scroll, x=moveToX, y=moveToY)

每個(gè)按鍵按下和松開兩個(gè)事件可以分開處理：

pyautogui.mouseDown(x=moveToX, y=moveToY, button='left')
pyautogui.mouseUp(x=moveToX, y=moveToY, button='left')

3.4 鍵盤函數(shù)

鍵盤上可以按的鍵都可以調(diào)用：

 #  每次鍵入的時(shí)間間隔
secs_between_keys = 0.1
pyautogui.typewrite('Hello world!\n', interval=secs_between_keys)

多個(gè)鍵也可以：

pyautogui.typewrite(['a', 'b', 'c', 'left', 'backspace', 'enter', 'f1'], interval=secs_between_keys)

按鍵名稱列表：

pyautogui.KEYBOARD_KEYS[:10]
['\t', '\n', '\r', ' ', '!', '"', '#', '$', '%', '&']

鍵盤的一些熱鍵像Ctrl-S或Ctrl-Shift-1都可以用hotkey()函數(shù)來實(shí)現(xiàn)：

pyautogui.hotkey('ctrl', 'a') # 全選
pyautogui.hotkey('ctrl', 'c') # 復(fù)制
pyautogui.hotkey('ctrl', 'v') # 粘貼

每個(gè)按鍵的按下和松開也可以單獨(dú)調(diào)用：

pyautogui.keyDown(key_name)
pyautogui.keyUp(key_name)

3.5 消息彈窗函數(shù)

如果你需要消息彈窗，通過單擊OK暫停程序，或者向用戶顯示一些信息，消息彈窗函數(shù)就會(huì)有類似JavaScript的功能：

pyautogui.alert('這個(gè)消息彈窗是文字+OK按鈕')
pyautogui.confirm('這個(gè)消息彈窗是文字+OK+Cancel按鈕')
pyautogui.prompt('這個(gè)消息彈窗是讓用戶輸入字符串，單擊OK')

在prompt()函數(shù)中，如果用戶什么都不輸入，就會(huì)返回None。

3.6 截屏函數(shù)

PyAutoGUI用Pillow/PIL庫實(shí)現(xiàn)圖片相關(guān)的識(shí)別和操作。

在Linux里面，你必須執(zhí)行sudo apt-get install scrot來使用截屏特性。

#  返回一個(gè)Pillow/PIL的Image對(duì)象
pyautogui.screenshot()
pyautogui.screenshot('foo.png')

如果你有一個(gè)圖片文件想在上面做點(diǎn)擊操作，你可以用locateOnScreen()函數(shù)來定位。

#  返回(最左x坐標(biāo)，最頂y坐標(biāo)，寬度，高度)
pyautogui.locateOnScreen('pyautogui/looks.png')
(0, 1040, 48, 40)

locateAllOnScreen()函數(shù)會(huì)尋找所有相似圖片，返回一個(gè)生成器：

for i in pyautogui.locateAllOnScreen('pyautogui/looks.png'):
    print(i)
 
(0, 1040, 48, 40)

list(pyautogui.locateAllOnScreen('pyautogui/looks.png'))
 
[(0, 1040, 48, 40)]

locateCenterOnScreen()函數(shù)會(huì)返回圖片在屏幕上的中心XY軸坐標(biāo)值：

pyautogui.locateCenterOnScreen('pyautogui/looks.png')
 
(24, 1060)

如果沒找到圖片會(huì)返回None。

定位比較慢，一般得用1~2秒

4 常用函數(shù)

position()：返回整數(shù)元組(x, y)，分別表示鼠標(biāo)光標(biāo)所在位置的XY軸坐標(biāo)
size()：返回顯示器的尺寸整數(shù)元組(x, y)。未來將加入多屏支持

5 鼠標(biāo)控制函數(shù)

5.1 屏幕與鼠標(biāo)位置

屏幕位置使用X和Y軸的笛卡爾坐標(biāo)系。原點(diǎn)(0,0)在左上角，分別向右、向下增大。

如果屏幕像素是$1920 \times 1080$，那么右下角的坐標(biāo)是(1919, 1079)。

分辨率大小可以通過size()函數(shù)返回整數(shù)元組。光標(biāo)的位置用position()返回。例如：

pyautogui.size()
 
(1920, 1080)

pyautogui.position()
 
(272, 688)

下面是Python 3版本的光標(biāo)位置記錄程序：

# ! python 3
import pyautogui
print('Press Ctrl-C to quit')
try:
    while True:
        x, y = pyautogui.position()
        positionStr = 'X: {} Y: {}'.format(*[str(x).rjust(4) for x in [x, y]])
        print(positionStr, end='')
        print('\b' * len(positionStr), end='', flush=True)
except KeyboardInterrupt:
    print('\n')

Python 2版本是：

# ! python
import pyautogui, sys
print('Press Ctrl-C to quit.')
try:
    while True:
        x, y = pyautogui.position()
        positionStr = 'X: ' + str(x).rjust(4) + ' Y: ' + str(y).rjust(4)
        print positionStr,
        print '\b' * (len(positionStr) + 2),
        sys.stdout.flush()
except KeyboardInterrupt:
    print '\n'

要檢查XY坐標(biāo)是否在屏幕上，需要用onScreen()函數(shù)來檢驗(yàn)，如果在屏幕上返回True：

import pyautogui
pyautogui.onScreen(0, 0)
 
True

pyautogui.onScreen(0, -1)
 
False

pyautogui.onScreen(0, 2080)
 
False

pyautogui.onScreen(1920, 1080) 

False

pyautogui.onScreen(1919, 1079)
 
True

5.2 鼠標(biāo)行為

moveTo()函數(shù)會(huì)把鼠標(biāo)光標(biāo)移動(dòng)到指定的XY軸坐標(biāo)處。如果傳入None值，則表示使用當(dāng)前光標(biāo)的對(duì)象軸坐標(biāo)值。

pyautogui.moveTo(100, 200)     # 光標(biāo)移動(dòng)到(100, 200)位置
pyautogui.moveTo(None, 500)   # 光標(biāo)移動(dòng)到(100, 500)位置
pyautogui.moveTo(600, None)   # 光標(biāo)移動(dòng)到(600, 500)位置

一般鼠標(biāo)光標(biāo)都是瞬間移動(dòng)到指定的位置，如果你想讓鼠標(biāo)移動(dòng)的慢點(diǎn)，可以設(shè)置持續(xù)時(shí)間：

pyautogui.moveTo(100, 200, duration=2)     # 用2秒把光標(biāo)移動(dòng)到(100, 200)位置

默認(rèn)的持續(xù)時(shí)間pyautogui.MINIMUM_DURATION是0.1秒，如果你設(shè)置的時(shí)間比默認(rèn)值還短，那么就會(huì)瞬間執(zhí)行。

如果你想讓光標(biāo)以當(dāng)前位置為原點(diǎn)，進(jìn)行相對(duì)移動(dòng)，就用pyautogui.moveRel()函數(shù)。例如：

pyautogui.moveTo(100, 200) #把光標(biāo)移動(dòng)到(100, 200)位置
pyautogui.moveRel(0, 50)   #向下移動(dòng)50
pyautogui.moveRel(30, 0, 2)   #向右移動(dòng)30
pyautogui.moveRel(30, None)   #向右移動(dòng)30

5.3 鼠標(biāo)拖拽

PyAutoGUI的dragTo()和dragRel()函數(shù)與moveTo()和moveRel()函數(shù)類似。另外，他們有一個(gè)button參數(shù)可以設(shè)置成left，middle和right三個(gè)鍵。例如：

# 按住鼠標(biāo)左鍵，把鼠標(biāo)拖拽到(100, 200)位置
pyautogui.dragTo(100, 200, button='left')
# 按住鼠標(biāo)左鍵，用2秒鐘把鼠標(biāo)拖拽到(300, 400)位置
pyautogui.dragTo(300, 400, 2, button='left')
# 按住鼠標(biāo)右鍵，用2秒鐘把鼠標(biāo)拖拽到(30,0)位置
pyautogui.dragTo(30, 0, 2, button='right')

5.4 緩動(dòng)/漸變（Tween / Easing）函數(shù)

緩動(dòng)/漸變函數(shù)的作用是讓光標(biāo)的移動(dòng)更炫。如果你不需要用到的話，你可以忽略這些。

緩動(dòng)/漸變函數(shù)可以改變光標(biāo)移動(dòng)過程的速度和方向。通常鼠標(biāo)是勻速直線運(yùn)動(dòng)，這就是線性緩動(dòng)/漸變函數(shù)。PyAutoGUI有30種緩動(dòng)/漸變函數(shù)，可以通過pyautogui.ease*?查看。其中，pyautogui.easeInQuad()函數(shù)可以用于moveTo()，moveRel()，dragTo()和dragRel()函數(shù)，光標(biāo)移動(dòng)呈現(xiàn)先慢后快的效果，整個(gè)過程的時(shí)間還是和原來一樣。而pyautogui.easeOutQuad函數(shù)的效果相反：光標(biāo)開始移動(dòng)很快，然后慢慢減速。pyautogui.easeOutElastic是彈簧效果，首先越過終點(diǎn)，然后再反彈回來。例如：

#  開始很慢，不斷加速
pyautogui.moveTo(100, 100, 2, pyautogui.easeInQuad)
#  開始很快，不斷減速
pyautogui.moveTo(100, 100, 2, pyautogui.easeOutQuad)
#  開始和結(jié)束都快，中間比較慢
pyautogui.moveTo(100, 100, 2, pyautogui.easeInOutQuad)
#  一步一徘徊前進(jìn)
pyautogui.moveTo(100, 100, 2, pyautogui.easeInBounce)
#  徘徊幅度更大，甚至超過起點(diǎn)和終點(diǎn)
pyautogui.moveTo(100, 100, 2, pyautogui.easeInElastic)

這些效果函數(shù)是模仿Al Sweigart的PyTweening模塊，可以直接使用，不需要額外安裝。

如果你想創(chuàng)建自己的效果，也可以定義一個(gè)函數(shù)，其參數(shù)是(0.0,1.0)，表示起點(diǎn)和終點(diǎn)，返回值是介于[0.0,1.0]之間的數(shù)。

5.5 鼠標(biāo)單擊

click()函數(shù)模擬單擊鼠標(biāo)左鍵一次的行為。例如：

pyautogui.click()

如果單機(jī)之前要先移動(dòng)，可以把目標(biāo)的XY坐標(biāo)值傳入函數(shù)：

#  先移動(dòng)到(100, 200)再單擊
pyautogui.click(x=100, y=200, duration=2)

可以通過button參數(shù)設(shè)置left，middle和right三個(gè)鍵。例如：

pyautogui.click(button='right')

要做多次單擊可以設(shè)置clicks參數(shù)，還有interval參數(shù)可以設(shè)置每次單擊之間的時(shí)間間隔。例如：

#  雙擊左鍵
pyautogui.click(clicks=2)
#  兩次單擊之間停留0.25秒
pyautogui.click(clicks=2, interval=0.25)
#  三擊右鍵
pyautogui.click(button='right', clicks=2, interval=0.25)

為了操作方便，PyAutoGUI提供了doubleClick()，tripleClick()和rightClick()來實(shí)現(xiàn)雙擊、三擊和右擊操作。

5.6 鼠標(biāo)按下和松開函數(shù)

mouseDown()和mouseUp()函數(shù)可以實(shí)現(xiàn)鼠標(biāo)按下和鼠標(biāo)松開的操作。兩者參數(shù)相同，有x，y和button。例如：

#  鼠標(biāo)左鍵按下再松開
pyautogui.mouseDown(); pyautogui.mouseUp() 
#  按下鼠標(biāo)右鍵
pyautogui.mouseDown(button='right') 
#  移動(dòng)到(100, 200)位置，然后松開鼠標(biāo)右鍵
pyautogui.mouseUp(button='right', x=100, y=200)

5.7 滾輪滾動(dòng)函數(shù)

鼠標(biāo)滾輪滾動(dòng)可以用scroll()函數(shù)和clicks次數(shù)參數(shù)來模擬。不同平臺(tái)上的clicks次數(shù)不太一樣。還有x和y參數(shù)可以在滾動(dòng)之前定位到(x, y)位置。例如：

#  向上滾動(dòng)10格
pyautogui.scroll(10)
#  向下滾動(dòng)10格
pyautogui.scroll(-10)
#  移動(dòng)到(100, 100)位置再向上滾動(dòng)10格
pyautogui.scroll(10, x=100, y=100)

在OS X和Linux平臺(tái)上，PyAutoGUI還可以用hscroll()實(shí)現(xiàn)水平滾動(dòng)。例如：

#  向右滾動(dòng)10格
pyautogui.hscroll(10)
#  向左滾動(dòng)10格
pyautogui.hscroll(-10)

scroll()函數(shù)是vscroll()的一個(gè)包裝（wrapper），執(zhí)行豎直滾動(dòng)。

6 鍵盤控制函數(shù)

6.1 typewrite()輸入函數(shù)

鍵盤控制的主要函數(shù)就是typewrite()。這個(gè)函數(shù)可以實(shí)現(xiàn)字符輸入。要在兩次輸入間增加時(shí)間間隔，可以用interval參數(shù)。例如：

#  輸入Hello world!
pyautogui.typewrite('Hello world!')
#  每次輸入間隔0.25秒，輸入Hello world!
pyautogui.typewrite('Hello world!', interval=0.25)

typewrite()函數(shù)只能用于單個(gè)字符鍵，不能按SHITF和F1這些功能鍵。

6.2 press()，keyDown()和keyUp()函數(shù)

要按那些功能鍵，可以用press()函數(shù)把pyautogui.KEYBOARD_KEYS里面按鍵對(duì)應(yīng)的字符串輸入進(jìn)去。例如：

#  ENTER鍵
pyautogui.press('enter')
#  F1鍵
pyautogui.press('f1')
#  左方向鍵
pyautogui.press('left')

press()函數(shù)其實(shí)是keyDown()和keyUp()函數(shù)的包裝，模擬的按下然后松開兩個(gè)動(dòng)作。這兩個(gè)函數(shù)可以單獨(dú)調(diào)用。例如，按下shift鍵的同時(shí)按3次左方向鍵：

#  按下`shift`鍵
pyautogui.keyDown('shift')
pyautogui.press('left')
pyautogui.press('left')
pyautogui.press('left')
#  松開`shift`鍵
pyautogui.keyUp('shift')

和typewrite()函數(shù)一樣，可以用數(shù)組把一組鍵傳入press()。例如：

pyautogui.press(['left', 'left', 'left'])

6.3 hotkey()函數(shù)

為了更高效的輸入熱鍵，PyAutoGUI提供了hotkey()函數(shù)來綁定若干按鍵：

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

等價(jià)于：

pyautogui.keyDown('ctrl')
pyautogui.keyDown('shift')
pyautogui.keyDown('esc')
pyautogui.keyUp('esc')
pyautogui.keyUp('shift')
pyautogui.keyUp('ctrl')

6.4 KEYBOARD_KEYS

下面就是press()，keyDown()，keyUp()和hotkey()函數(shù)可以輸入的按鍵名稱：

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', 'stop', 'subtract', 'tab', 'up', 'volumedown', 'volumemute', 'volumeup', 'win', 'winleft', 'winright', 'yen', 'command', 'option', 'optionleft', 'optionright']

7 消息彈窗函數(shù)

PyAutoGUI通過Tkinter實(shí)現(xiàn)了4種純Python的消息彈窗函數(shù)，和JavaScript類似。

7.1 alert()函數(shù)

pyautogui.alert(text='', title='', button='OK')
 
'OK'

顯示一個(gè)簡(jiǎn)單的帶文字和OK按鈕的消息彈窗。用戶點(diǎn)擊后返回button的文字。

7.2 The confirm() Function

#  OK和Cancel按鈕的消息彈窗
pyautogui.confirm(text='', title='', buttons=['OK', 'Cancel'])
#  10個(gè)按鍵0-9的消息彈窗
pyautogui.confirm(text='', title='', buttons=range(10))
 
'0'

顯示一個(gè)簡(jiǎn)單的帶文字、OK和Cancel按鈕的消息彈窗，用戶點(diǎn)擊后返回被點(diǎn)擊button的文字，支持自定義數(shù)字、文字的列表。

7.3 The prompt() Function

pyautogui.prompt(text='', title='' , default='')

可以輸入的消息彈窗，帶OK和Cancel按鈕。用戶點(diǎn)擊OK按鈕返回輸入的文字，點(diǎn)擊Cancel按鈕返回None。

7.4 The password() Function

pyautogui.password(text='', title='', default='', mask='*')

樣式同prompt()，用于輸入密碼，消息用*表示。帶OK和Cancel按鈕。用戶點(diǎn)擊OK按鈕返回輸入的文字，點(diǎn)擊Cancel按鈕返回None。

8 截屏函數(shù)

PyAutoGUI可以截屏并保存為圖片文件，然后定位這些截屏在屏幕上的位置。與sikuli類似，把屏幕上的按鍵截取下來，然后定位，就可以執(zhí)行點(diǎn)擊等操作了。

截屏功能需要安裝Pillow模塊。OS X用screencapture命令，是系統(tǒng)自帶的。Linux用戶用scrot命令，可以通過sudo apt-get install scrot安裝。

8.1 Ubuntu注意事項(xiàng)

由于Ubuntu上安裝Pillow時(shí)缺少PNG和JPEG依賴，所以安裝比較復(fù)雜，具體可以看 Ubuntu論壇。不過用 miniconda可以解決這些問題，如果Ubuntu或Mint上安裝了miniconda，可以直接conda install pillow來安裝。

8.2 screenshot()函數(shù)

screenshot()函數(shù)會(huì)返回Image對(duì)象（參考Pillow或PIL模塊文檔），也可以設(shè)置文件名：

import pyautogui
im1 = pyautogui.screenshot()
im2 = pyautogui.screenshot('my_screenshot.png')

在一個(gè)$1920 \times 1080$的屏幕上，screenshot()函數(shù)要消耗100微秒——不快也不慢。

如果你不需要截取整個(gè)屏幕，還有一個(gè)可選的region參數(shù)。你可以把截取區(qū)域的左上角XY坐標(biāo)值和寬度、高度傳入截取。

im = pyautogui.screenshot(region=(0, 0, 300 ,400))

8.3 定位函數(shù)

可以定位截圖在屏幕上的坐標(biāo)位置。比如，你需要在計(jì)算器里輸入：

如果你不知道按鈕的位置，就不能用moveTo()定位和click()點(diǎn)擊。而且每次計(jì)算器的位置可能會(huì)變化，這時(shí)即使有來坐標(biāo)也不好用了。但是如果你有要點(diǎn)擊按鈕的截圖，比如數(shù)字7：

你可以調(diào)用pyautogui.locateOnScreen('calc7key.png')函數(shù)來獲得7的屏幕坐標(biāo)。返回的是一個(gè)元組(top, left, width, height)。這個(gè)元組可以用pyautogui.center()函數(shù)來獲取截圖屏幕的中心坐標(biāo)。如果截圖沒找到，pyautogui.locateOnScreen()函數(shù)返回None：

import pyautogui
button7location = pyautogui.locateOnScreen('pyautogui/calc7key.png')
button7location
 
(1226, 546, 29, 28)

button7x, button7y = pyautogui.center(button7location)
button7x, button7y
 
(1240, 560)

pyautogui.click(button7x, button7y)

locateCenterOnScreen()等價(jià)于上面的前兩布操作，直接獲得截屏屏幕中心坐標(biāo)：

import pyautogui
x, y = pyautogui.locateCenterOnScreen('pyautogui/calc7key.png')
pyautogui.click(x, y)

在$1920 \times 1080$的屏幕上，定位函數(shù)需要1~2秒時(shí)間。對(duì)視頻游戲（LOL、DOTA）來說就太慢了，但是上班干活還是綽綽有余。

還是幾個(gè)定位函數(shù)。都是從左上角原點(diǎn)開始向右向下搜索截圖位置：

locateOnScreen(image, grayscale=False)：返回找到的第一個(gè)截圖Image對(duì)象在屏幕上的坐標(biāo)(left, top, width, height)，如果沒找到返回None
locateCenterOnScreen(image, grayscale=False)：返回找到的第一個(gè)截圖Image對(duì)象在屏幕上的中心坐標(biāo)(x, y)，如果沒找到返回None
locateAllOnScreen(image, grayscale=False)：返回找到的所有相同截圖Image對(duì)象在屏幕上的坐標(biāo)(left, top, width, height)的生成器
locate(needleImage, haystackImage, grayscale=False)：返回找到的第一個(gè)截圖Image對(duì)象在haystackImage里面的坐標(biāo)(left, top, width, height)，如果沒找到返回None
locateAll(needleImage, haystackImage, grayscale=False)：返回找到的所有相同截圖Image對(duì)象在haystackImage里面的坐標(biāo)(left, top, width, height)的生成器

兩個(gè)locateAll*函數(shù)都可以用for循環(huán)和list()輸出：

 for pos in pyautogui.locateAllOnScreen('pyautogui/calc7key.png'):
    print(pos)
 
(1227, 546, 29, 28)

list(pyautogui.locateAllOnScreen('pyautogui/calc7key.png'))
 
[(1227, 546, 29, 28)]

8.3.1 灰度值匹配

可以把grayscale參數(shù)設(shè)置為True來加速定位（大約提升30%），默認(rèn)為False。這種去色（desaturate）方法可以加速定位，但是也可能導(dǎo)致假陽性（false-positive）匹配：

import pyautogui
button7location = pyautogui.locateOnScreen('pyautogui/calc7key.png', grayscale=True)
button7location
 
(1227, 546, 29, 28)

8.3.2 像素匹配

要獲取截屏某個(gè)位置的RGB像素值，可以用Image對(duì)象的getpixel()方法：

 import pyautogui
im = pyautogui.screenshot()
im.getpixel((100, 200))
 
(255, 255, 255)

也可以用PyAutoGUI的pixel()函數(shù)，是之前調(diào)用的包裝：

pyautogui.pixel(100, 200)
 
(255, 255, 255)

如果你只是要檢驗(yàn)一下指定位置的像素值，可以用pixelMatchesColor()函數(shù)，把X、Y和RGB元組值穿入即可：

pyautogui.pixelMatchesColor(100, 200, (255, 255, 255))
 
True

pyautogui.pixelMatchesColor(100, 200, (255, 255, 245))
 
False

tolerance參數(shù)可以指定紅、綠、藍(lán)3種顏色誤差范圍：

pyautogui.pixelMatchesColor(100, 200, (255, 255, 245), tolerance=10)
 
True

pyautogui.pixelMatchesColor(100, 200, (248, 250, 245), tolerance=10)
 
True

pyautogui.pixelMatchesColor(100, 200, (205, 255, 245), tolerance=10)
 
False

總結(jié)

到此這篇關(guān)于Python中PyAutoGUI幫助文檔的文章就介紹到這了,更多相關(guān)PyAutoGUI幫助文檔內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

您可能感興趣的文章:

欧美bbbwbbbw肥妇,免费乱码人妻系列日韩,一级黄片