# 默認這項功能為True, 這項功能意味著：當鼠標的指針在屏幕的最坐上方，程序會報錯；目的是為了防止程序無法停止
pyautogui.FAILSAFE =False  

# 意味著所有pyautogui的指令都要暫停一秒；其他指令不會停頓；這樣做，可以防止鍵盤鼠標操作太快；
pyautogui.PAUSE = 1    

print(pyautogui.size())   # 返回所用顯示器的分辨率； 輸出：Size(width=1920, height=1080)
width,height = pyautogui.size()
print(width,height)  # 1920 1080

# 將鼠標移動到指定的坐標；duration 的作用是設置移動時間，所有的gui函數都有這個參數，而且都是可選參數；
# 向右移動100px，向下移動500px, 這個過程持續(xù) 1 秒鐘；
pyautogui.moveTo(100,300,duration=1)   

print(pyautogui.position())   # 得到當前鼠標位置；輸出：Point(x=200, y=800)

# 點擊鼠標
pyautogui.click(10,10)   # 鼠標點擊指定位置，默認左鍵
pyautogui.click(10,10,button='left')  # 單擊左鍵
pyautogui.click(1000,300,button='right')  # 單擊右鍵
pyautogui.click(1000,300,button='middle')  # 單擊中間

pyautogui.doubleClick(10,10)  # 指定位置，雙擊左鍵
pyautogui.rightClick(10,10)   # 指定位置，雙擊右鍵
pyautogui.middleClick(10,10)  # 指定位置，雙擊中鍵

pyautogui.mouseDown()   # 鼠標按下
pyautogui.mouseUp()    # 鼠標釋放

# 拖動到指定位置
# 將鼠標拖動到指定的坐標；duration 的作用是設置移動時間，所有的gui函數都有這個參數，而且都是可選參數
pyautogui.dragTo(100,300,duration=1)   

# 按方向拖動
# 向右拖動100px，向下拖動500px, 這個過程持續(xù) 1 秒鐘
pyautogui.dragRel(100,500,duration=4)   # 第一個參數是左右移動像素值，第二個是上下

# 控制鼠標滾動的函數是scroll()， 傳入一個整數的參數，說明向上或向下滾動多少個單位；單位根據操作系統(tǒng)不同而不同
pyautogui.scroll(300)  # 向下滾動300個單位；

pyautogui.keyDown('shift')    # 按下shift
pyautogui.press('4')    # 按下 4
pyautogui.keyUp('shift')   # 釋放 shift

pyautogui.typewrite('$*……%……￥', 0.5)

pyautogui.typewrite(['T','i','s','left','left','h',])   # 輸出：This

pyautogui.keyDown('ctrl')
pyautogui.keyDown('c')
pyautogui.keyUp('c')
pyautogui.keyUp('ctrl')

pyautogui.hotkey('ctrl','c')

im = pyautogui.screenshot() # 返回屏幕的截圖，是一個Pillow的image對象
im.getpixel((500, 500)) # 返回im對象上，（500，500）這一點像素的顏色，是一個RGB元組
pyautogui.pixelMatchesColor(500,500,(12,120,400)) # 是一個對比函數，對比的是屏幕上（500，500）這一點像素的顏色，與所給的元素是否相同；

im = pyautogui.screenshot()
im.save('屏幕截圖.png')