pyautogui.locateonscreen

PyAutoGUI是一个Python库，用于自动化 GUI 操作，它包含了对屏幕截图、鼠标点击、键盘输入等功能的支持。`pyautogui.locateOnScreen()`函数是该库中的一个重要功能，用于查找屏幕上的图像或特定区域，并返回其在屏幕上的坐标位置。

当你提供一张图片作为参数给这个函数时，它会在当前显示的窗口中搜索是否存在与指定图片相似的部分。如果找到匹配的区域，它会返回一个元组，包含(x, y)坐标，即匹配图像左上角的位置；如果没有找到，则返回None。

例如，你可以这样做：

from PIL import ImageGrab
import pyautogui

# 获取当前屏幕快照并转换为Image对象
screenshot = ImageGrab.grab()
# 使用locateOnScreen搜索特定图像
match_location = pyautogui.locateOnScreen('image_to_find.png')
if match_location is not None:
    print(f"找到了匹配图像，位置: {match_location}")
else:
    print("未找到匹配图像")