帮助中心
快速寻找答案
首页>帮助手册>

xbot.win32.Image

描述:是对图像进行常规处理,如等待图像出现/消失、点击图像、将鼠标移动到图像上

方法

wait_appear()

在当前屏幕中等待与图像库匹配的图片出现

wait_appear(image_selectors , wait_all=False, timeout=20)

输入参数

image_selectors:图像选择器, 支持以下格式:

- 'img' 或 package.image_selector('img')
- ['img1', 'img2'] 或 [package.image_selector('img1'),package.image_selector('img2')]

:以上 'img' 'img1' 'img2',都为图像库中图像的名称

wait_all:是否等待全部目标图片出现后再执行,默认值为False(不等待全部图片出现)

timeout:等待目标图片出现的超时时间,默认时间为20s

返回值

bool:在指定延迟时间内如果目标元素出现则返回True,否则返回False

示例1

from xbot import win32
def main(args):
appear = win32.image.wait_appear("图像1")

该示例执行逻辑: 在当前屏幕中等待与图像选择器 图像1 匹配的图像出现

wait_appear_from_window()

在当前激活的窗口中等待与图像选择器匹配的图片出现

wait_appear_from_window(hWnd, image_selectors, wait_all=False, timeout=20)

输入参数

hWnd:目标窗口的句柄

image_selectors:图像选择器, 支持以下格式:

- 'img' 或 package.image_selector('img')
- ['img1', 'img2'] 或 [package.image_selector('img1'),package.image_selector('img2')]

:以上 'img' 'img1' 'img2',都为图像库中图像的名称

wait_all:是否等待全部目标图片出现后再执行,默认值为False(不等待全部图片出现)

timeout:等待目标图片出现的超时时间,默认时间为20s

返回值

bool:在指定延迟时间内如果目标元素出现则返回True, 否则返回False

示例1

from xbot import win32
from . import package
def main(args):
hWnd = win32.get('新建文本').hWnd
appear = win32.image.wait_appear_from_window(hWnd, "图像1")

该示例执行逻辑: 获取窗口名标题为 新建文本 的窗口句柄 --> 在当前屏幕中等待与图像选择器 图像1 匹配的图像出现

wait_disappear()

在当前屏幕中等待与图像选择器匹配的图片消失

wait_disappear(image_selectors , wait_all=False, timeout=20)

输入参数

image_selectors:图像选择器, 支持以下格式:

- 'img' 或 package.image_selector('img')
- ['img1', 'img2'] 或 [package.image_selector('img1'),package.image_selector('img2')]

:以上 'img' 'img1' 'img2',都为图像库中图像的名称

wait_all:是否等待全部目标图片消失后再执行,默认值为False(不等待全部图片出现)

timeout:等待目标图片消失的超时时间,默认时间为20s

返回值

bool:在指定延迟时间内如果目标元素消失则返回True, 否则返回False

示例1

在当前屏幕中等待与图像选择器 图像1 匹配的图像消失

from xbot import win32
def main(args):
appear = win32.image.wait_disappear('图像1')

该示例执行逻辑: 在当前屏幕中等待与图像选择器 图像1 匹配的图像消失

wait_disappear_from_window()

在当前激活的窗口中等待与图像选择器匹配的图片消失

wait_disappear_from_window(hWnd, image_selectors, wait_all=False , timeout=20)

输入参数

hWnd:目标窗口的句柄

image_selectors:图像选择器, 支持以下格式:

- 'img' 或 package.image_selector('img')
- ['img1', 'img2'] 或 [package.image_selector('img1'),package.image_selector('img2')]

:以上 'img' 'img1' 'img2',都为图像库中图像的名称

wait_all:是否等待全部目标图片消失后再执行,默认值为False(不等待全部图片出现)

timeout:等待目标图像消失的超时时间,默认时间为20s

返回值

bool:在指定延迟时间内如果目标元素消失则返回True, 否则返回False

示例1

在当前激活的窗口中等待与图像选择器 图像1 匹配的图像消失

from xbot import win32
def main(args):
hWnd = win32.get('新建文本').hWnd
appear = win32.image.wait_disappear_from_window(hWnd, "图像1")

该示例执行逻辑: 获取窗口名标题为 新建文本 的窗口句柄 --> 在当前屏幕中等待与图像选择器 图像1 匹配的图像出现

hover()

在当前屏幕上查找与图像选择器匹配的图片并将鼠标悬停在上面

hover(image_selectors , anchor=None)

输入参数

image_selectors:图像选择器, 支持以下格式:

- 'img' 或 package.image_selector('img')
- ['img1', 'img2'] 或 [package.image_selector('img1'),package.image_selector('img2')]

:以上 'img' 'img1' 'img2',都为图像库中图像的名称

anchor:锚点,鼠标点击元素的位置以及偏移量元组,可为 None,默认值为 None(点击目标中心且无偏移量),参数结构如下:

sudoku_part:鼠标悬停的位置, 默认悬停在中心,

|参数内容|解释|
|:---|:---|
|'topLeft'|悬停左上角|
|'topCenter'|悬停在上中部|
|'topRight'|悬停在右上角|
|'middleLeft'|悬停在左中部|
|'middleCenter'|悬停在中心|
|'middleRight'|悬停在右中部|
|'bottomLeft'|悬停左下角|
|'bottomCenter'|悬停在下中部|
|'bottomRight'|悬停在右下角|

offset_x:鼠标位置的水平偏移量

offset_y:鼠标位置的垂直偏移量

返回值

示例1

from xbot import win32
def main(args):
win32.image.hover('图像1', anchor=('middleCenter', 100, 100))

该示例执行逻辑: 在当前屏幕中查找与图像选择器 图像1 匹配的图像出现并将鼠标悬停在目标图像的中间,鼠标坐标的水平和垂直偏移量都为100

hover_on_window()

在当前屏幕上查找与图像选择器匹配的图片并将鼠标悬停在上面

hover_on_window(hWnd, image_selectors , anchor=None)

输入参数

hWnd:目标窗口的句柄

image_selectors:图像选择器, 支持以下格式:

- 'img' 或 package.image_selector('img')
- ['img1', 'img2'] 或 [package.image_selector('img1'),package.image_selector('img2')]

:以上 'img' 'img1' 'img2',都为图像库中图像的名称

anchor:锚点,鼠标点击元素的位置以及偏移量元组,可为 None,默认值为 None(点击目标中心且无偏移量),参数结构如下:

sudoku_part:鼠标悬停的位置, 默认悬停在中心,

|参数内容|解释|
|:---|:---|
|'topLeft'|悬停左上角|
|'topCenter'|悬停在上中部|
|'topRight'|悬停在右上角|
|'middleLeft'|悬停在左中部|
|'middleCenter'|悬停在中心|
|'middleRight'|悬停在右中部|
|'bottomLeft'|悬停左下角|
|'bottomCenter'|悬停在下中部|
|'bottomRight'|悬停在右下角|

offset_x:鼠标位置的水平偏移量

offset_y:鼠标位置的垂直偏移量

返回值

示例1

from xbot import win32
def main(args):
hWnd = win32.get('新建文本').hWnd
win32.image.hover_on_window(hWnd, '图像1', anchor=('middleCenter', 100, 100))

该示例执行逻辑: 获取窗口名标题为 新建文本 的窗口句柄 --> 在当前激活的窗口中查找与图像选择器 图像1 匹配的图像出现并将鼠标悬停在目标图像的中间,鼠标坐标的水平和垂直偏移量都为100

click()

在这当前屏幕上查找与图像选择器相似的图像并单击

click(image_selectors , anchor=None, button='left', keys='none', move_mouse=True)

输入参数

image_selectors:图像选择器, 支持以下格式:

- 'img' 或 package.image_selector('img')
- ['img1', 'img2'] 或 [package.image_selector('img1'),package.image_selector('img2')]

anchor:锚点,鼠标点击元素的位置以及偏移量元组,可为 None,默认值为 None(点击目标中心且无偏移量),参数结构如下:

sudoku_part:鼠标悬停的位置, 默认悬停在中心,

|参数内容|解释|
|:---|:---|
|'topLeft'|悬停左上角|
|'topCenter'|悬停在上中部|
|'topRight'|悬停在右上角|
|'middleLeft'|悬停在左中部|
|'middleCenter'|悬停在中心|
|'middleRight'|悬停在右中部|
|'bottomLeft'|悬停左下角|
|'bottomCenter'|悬停在下中部|
|'bottomRight'|悬停在右下角|

offset_x:鼠标位置的水平偏移量

offset_y:鼠标位置的垂直偏移量

button:单击时鼠标按下的按键,可以传入'left'(鼠标左键) 或 'right'(鼠标右键),默认为 'left'

keys:点击鼠标时的键盘辅助按钮,可用辅助按键有——nonealtctrlshiftwin,默认为 'none'

move_mouse:是否显示鼠标移动轨迹,默认值为True(显示鼠标移动轨迹)

返回值

示例1

from xbot import win32
def main(args):
win32.image.click('图像1', anchor=('middleCenter', 100, 100),
button='left', keys='alt', move_mouse=True)

该示例执行逻辑: 在当前屏幕中查找与图像选择器 图像1 匹配的图像出现并用鼠标左键点击图像的中间,鼠标点击坐标的水平和垂直偏移量都为100,点击同时按下键盘 Alt 键,移动鼠标时显示鼠标移动轨迹

click_on_window()

在这当前激活的窗口中查找与图像选择器相似的图像并单击

click_on_window(hWnd, image_selectors, anchor=None, button='left', keys='none', move_mouse=True)

输入参数

hWnd:目标窗口的句柄

image_selectors:图像选择器, 支持以下格式:

- 'img' 或 package.image_selector('img')
- ['img1', 'img2'] 或 [package.image_selector('img1'),package.image_selector('img2')]

anchor:锚点,鼠标点击元素的位置以及偏移量元组,可为 None,默认值为 None(点击目标中心且无偏移量),参数结构如下:

sudoku_part:鼠标悬停的位置, 默认悬停在中心,

|参数内容|解释|
|:---|:---|
|'topLeft'|悬停左上角|
|'topCenter'|悬停在上中部|
|'topRight'|悬停在右上角|
|'middleLeft'|悬停在左中部|
|'middleCenter'|悬停在中心|
|'middleRight'|悬停在右中部|
|'bottomLeft'|悬停左下角|
|'bottomCenter'|悬停在下中部|
|'bottomRight'|悬停在右下角|

offset_x:鼠标位置的水平偏移量

offset_y:鼠标位置的垂直偏移量

button:单击时鼠标按下的按键,可以传入'left'(鼠标左键) 或 'right'(鼠标右键),默认为 'left'

keys:点击鼠标时的键盘辅助按钮,可用辅助按键有——nonealtctrlshiftwin,默认为 'none'

返回值

示例1

from xbot import win32
from .package import *
def main(args):
hWnd = win32.get('新建文本').hWnd
win32.image.click_on_window(hWnd, '图像1', anchor=('middleCenter', 100, 100),
button='left', keys='alt', move_mouse=True)

该示例执行逻辑: 获取窗口名标题为 新建文本 的窗口句柄 --> 在当前激活的窗口中查找与图像选择器 图像1 匹配的图像出现并用鼠标左键点击图像的中间,鼠标点击坐标的水平和垂直偏移量都为100,点击同时按下键盘 Alt 键,移动鼠标时显示鼠标移动轨迹

dblclick()

在这当前屏幕上查找与图像选择器相似的图像并双击

dblclick(image_selectors , anchor=None, move_mouse=True)

输入参数

image_selectors:图像选择器, 支持以下格式:

- 'img' 或 package.image_selector('img')
- ['img1', 'img2'] 或 [package.image_selector('img1'),package.image_selector('img2')]

anchor:锚点,鼠标点击元素的位置以及偏移量元组,可为 None,默认值为 None(点击目标中心且无偏移量),参数结构如下:

sudoku_part:鼠标悬停的位置, 默认悬停在中心,

|参数内容|解释|
|:---|:---|
|'topLeft'|悬停左上角|
|'topCenter'|悬停在上中部|
|'topRight'|悬停在右上角|
|'middleLeft'|悬停在左中部|
|'middleCenter'|悬停在中心|
|'middleRight'|悬停在右中部|
|'bottomLeft'|悬停左下角|
|'bottomCenter'|悬停在下中部|
|'bottomRight'|悬停在右下角|

offset_x:鼠标位置的水平偏移量

offset_y:鼠标位置的垂直偏移量

move_mouse:是否显示鼠标移动轨迹,默认值为True(显示鼠标移动轨迹)

返回值

示例1

from xbot import win32
def main(args):
win32.image.dblclick('图像1', anchor=('middleCenter', 100, 100), move_mouse=True)

该示例执行逻辑: 在当前屏幕中查找与图像选择器 图像1 匹配的图像出现并用鼠标双击图像的中间,鼠标双击坐标的水平和垂直偏移量都为100,移动鼠标时显示鼠标移动轨迹

dblclick_on_window()

在这当前激活的窗口中查找与图像选择器相似的图像并双击

dblclick_on_window(hWnd, image_selectors, * * * , anchor=None, move_mouse=True)

输入参数

hWnd:目标窗口的句柄

image_selectors:图像选择器, 支持以下格式:

- 'img' 或 package.image_selector('img')
- ['img1', 'img2'] 或 [package.image_selector('img1'),package.image_selector('img2')]

anchor:锚点,鼠标点击元素的位置以及偏移量元组,可为 None,默认值为 None(点击目标中心且无偏移量),参数结构如下:

sudoku_part:鼠标悬停的位置, 默认悬停在中心,

|参数内容|解释|
|:--|:---|
|'topLeft'|悬停左上角|
|'topCenter'|悬停在上中部|
|'topRight'|悬停在右上角|
|'middleLeft'|悬停在左中部|
|'middleCenter'|悬停在中心|
|'middleRight'|悬停在右中部|
|'bottomLeft'|悬停左下角|
|'bottomCenter'|悬停在下中部|
|'bottomRight'|悬停在右下角|

offset_x:鼠标位置的水平偏移量

offset_y:鼠标位置的垂直偏移量

move_mouse:是否显示鼠标移动轨迹,默认值为True(显示鼠标移动轨迹)

返回值

示例1

from xbot import win32
def main(args):
hWnd = win32.get('新建文件').hWnd
win32.image.dblclick_on_window(hWnd, '图像1', anchor=('middleCenter', 100, 100),
move_mouse=True)

该示例执行逻辑: 获取窗口名标题为 新建文本 的窗口句柄 --> 在当前激活的窗口中查找与图像选择器 图像1 匹配的图像出现并用鼠标双击图像的中间,鼠标双击坐标的水平和垂直偏移量都为100,移动鼠标时显示鼠标移动轨迹

问题没有解决?去社区提问