pyautogui.position()

pyautogui.size()

 pyautogui.onScreen(x, y)

pyautogui.PAUSE = 2.5

pyautogui.FAILSAFE = True

pyautogui.moveTo(x, y, duration=num_seconds)

pyautogui.moveRel(xOffset, yOffset, duration=num_seconds) 

pyautogui.dragTo(x, y, duration=num_seconds)

pyautogui.dragRel(xOffset, yOffset, duration=num_seconds)

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

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

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

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

pyautogui.typewrite('Hello world!\n', interval=secs_between_keys)

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

pyautogui.hotkey('ctrl', 'c')  # ctrl-c 復制
pyautogui.hotkey('ctrl', 'v')  # ctrl-v 粘貼

pyautogui.keyDown(鍵名稱)
pyautogui.keyUp(鍵名稱) 

pyautogui.alert('這將顯示帶有確定按鈕的文本。')
pyautogui.confirm('這將顯示帶有確定和取消按鈕的文本。')
pyautogui.prompt('這樣用戶就可以輸入一個字符串，然后按確定。')

pyautogui.screenshot()  # 返回Pillow/PIL圖像對象
pyautogui.screenshot('foo.png')  # 返回Pillow/PIL圖像對象，并將其保存到文件

pyautogui.locateOnScreen('looksLikeThis.png') 

>>> pyautogui.size()
(1920, 1080)

>>> pyautogui.position()
(187, 567)

>>> pyautogui.onScreen(0, 0)
True
>>> pyautogui.onScreen(0, -1)
False
>>> pyautogui.onScreen(0, 99999999)
False

>>> pyautogui.moveTo(100, 200)   # moves mouse to X of 100, Y of 200.
>>> pyautogui.moveTo(None, 500)  # moves mouse to X of 100, Y of 500.
>>> pyautogui.moveTo(600, None)  # moves mouse to X of 600, Y of 500.

>>> pyautogui.moveTo(100, 200, 2)   # moves mouse to X of 100, Y of 200 over 2 seconds

>>> pyautogui.moveTo(100, 200)  # moves mouse to X of 100, Y of 200.
>>> pyautogui.move(0, 50)       # move the mouse down 50 pixels.
>>> pyautogui.move(-30, 0)      # move the mouse left 30 pixels.
>>> pyautogui.move(-30, None)   # move the mouse left 30 pixels.

>>> pyautogui.dragTo(100, 200, button='left')     # drag mouse to X of 100, Y of 200 while holding down left mouse button
>>> pyautogui.dragTo(300, 400, 2, button='left')  # drag mouse to X of 300, Y of 400 over 2 seconds while holding down left mouse button
>>> pyautogui.drag(30, 0, 2, button='right')   # drag the mouse left 30 pixels over 2 seconds while holding down the right mouse button

>>> pyautogui.click()  # click the mouse
>>> pyautogui.click(x=100, y=200)  # move to 100, 200, then click the left mouse button.
>>> pyautogui.click(button='right')  # right-click the mouse
>>> pyautogui.click(clicks=2)  # double-click the left mouse button
>>> pyautogui.click(clicks=2, interval=0.25)  # double-click the left mouse button, but with a quarter second pause in between clicks
>>> pyautogui.click(button='right', clicks=3, interval=0.25)  ## triple-click the right mouse button with a quarter second pause in between clicks

>>> pyautogui.doubleClick()  # perform a left-button double click

>>> pyautogui.mouseDown(); pyautogui.mouseUp()  # does the same thing as a left-button mouse click
>>> pyautogui.mouseDown(button='right')  # press the right button down
>>> pyautogui.mouseUp(button='right', x=100, y=200)  # move the mouse to 100, 200, then release the right button up.

>>> pyautogui.scroll(10)   # scroll up 10 "clicks"
>>> pyautogui.scroll(-10)  # scroll down 10 "clicks"
>>> pyautogui.scroll(10, x=100, y=100)  # move mouse cursor to 100, 200, then scroll up 10 "clicks"

>>> pyautogui.hscroll(10)   # scroll right 10 "clicks"
>>> pyautogui.hscroll(-10)   # scroll left 10 "clicks"

>>> pyautogui.write('Hello world!')                 # prints out "Hello world!" instantly
>>> pyautogui.write('Hello world!', interval=0.25)  # prints out "Hello world!" with a quarter second delay after each character

>>> pyautogui.press('enter')  # press the Enter key
>>> pyautogui.press('f1')     # press the F1 key
>>> pyautogui.press('left')   # press the left arrow key

>>> with pyautogui.hold('shift'):
        pyautogui.press(['left', 'left', 'left'])

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

>>> alert(text='', title='', button='OK')

>>> confirm(text='', title='', buttons=['OK', 'Cancel'])

>>> prompt(text='', title='' , default='')

>>> password(text='', title='', default='', mask='*')

>>> import pyautogui
>>> im1 = pyautogui.screenshot()
>>> im2 = pyautogui.screenshot('my_screenshot.png')  # 捕獲并保存到本地
>>> im3 = pyautogui.screenshot(region=(0,0, 300, 400))  # 捕獲指定范圍

>>> import pyautogui
>>> im = pyautogui.screenshot()
>>> im.getpixel((100, 200))
(130, 135, 144)

>>> import pyautogui
>>> pyautogui.pixelMatchesColor(100, 200, (130, 135, 144))
True
>>> pyautogui.pixelMatchesColor(100, 200, (0, 0, 0))
False

import pyautogui
import time

while True:
    # 本頁存在指定圖標
    if pyautogui.locateOnScreen('icon.png'):
        time.sleep(0.5)    # 等待 0.5 秒
        position = pyautogui.center(pyautogui.locateOnScreen('icon.png'))    # 尋找圖標的中心
        pyautogui.click(position)    # 點擊
    # 本頁不存在指定圖標
    else:  
        pyautogui.scroll(-500)    # 滾動鼠標，進入下一頁

# 案例獲取鼠標的位置，方便復制我們定位的鼠標坐標點到代碼中
import pyautogui
import time
 
 
# 獲取鼠標位置
def get_mouse_positon():
  time.sleep(5) # 準備時間
  print('開始獲取鼠標位置')
  try:
    for i in range(10):
      # Get and print the mouse coordinates.
      x, y = pyautogui.position()
      positionStr = '鼠標坐標點（X,Y）為：{},{}'.format(str(x).rjust(4), str(y).rjust(4))
      pix = pyautogui.screenshot().getpixel((x, y)) # 獲取鼠標所在屏幕點的RGB顏色
      positionStr += ' RGB:(' + str(pix[0]).rjust(3) + ',' + str(pix[1]).rjust(3) + ',' + str(pix[2]).rjust(
        3) + ')'
      print(positionStr)
      time.sleep(0.5) # 停頓時間
  except:
    print('獲取鼠標位置失敗')
 
 
if __name__ == "__main__":
  get_mouse_positon()