win32

要使用win32模块，需要使用rpa.win32。

win32模块是用来向用户提供一系列操作Windows控件的SDK，让用户通过简单的参数和方法调用来实现一些复杂的操作。

win_activate

方法名：
win_activate(title,*,mode=’start’)

方法描述：
该方法会激活窗口。

版本信息：
该方法适用于从3.3.0及以上版本。

参数说明：

title : 窗口标题
mode : 窗口匹配模式 ‘start’|’subStr’|’exact’|’reg’
- start:以指定title开始的窗体
- subStr:包含指定title的窗体
- exact:完全匹配指定title的窗体
- reg:title正则匹配指定title的窗体

返回值说明：
无

示例：

# 打开了ie浏览器
page = rpa.ie.create("www.baidu.com")
# 激活窗口
rpa.win32.win_activate("百度一下",mode='start')#默认为'start',可省略

win_minimize

方法名：
win_minimize(title,*,mode=’start’)

方法描述：
窗口最小化。

版本信息：
该方法适用于从3.3.0及以上版本。

参数说明：

title : 窗口标题
mode : 窗口匹配模式 ‘start’|’subStr’|’exact’|’reg’
- start:以指定title开始的窗体
- subStr:包含指定title的窗体
- exact:完全匹配指定title的窗体
- reg:title正则匹配指定title的窗体

返回值说明：
无

示例：

# 最小化窗口
rpa.win32.win_minimize("百度一下",mode='start')#默认为'start',可省略

win_maximize

方法名：
win_maximize(title,*,mode=’start’)

方法描述：
窗口最大化。

版本信息：
该方法适用于从3.3.0及以上版本。

参数说明：

title : 窗口标题
mode : 窗口匹配模式 ‘start’|’subStr’|’exact’|’reg’
- start:以指定title开始的窗体
- subStr:包含指定title的窗体
- exact:完全匹配指定title的窗体
- reg:title正则匹配指定title的窗体

返回值说明：
无

示例：

# 最大化窗口
rpa.win32.win_maximize("百度一下",mode='start')#默认为'start',可省略

win_hide

方法名：
win_hide(title,*,mode=’start’)

方法描述：
窗口隐藏，在任务栏不显示。

版本信息：
该方法适用于从3.3.0及以上版本。

参数说明：

title : 窗口标题
mode : 窗口匹配模式 ‘start’|’subStr’|’exact’|’reg’
- start:以指定title开始的窗体
- subStr:包含指定title的窗体
- exact:完全匹配指定title的窗体
- reg:title正则匹配指定title的窗体

返回值说明：
无

示例：

# 隐藏窗口
rpa.win32.win_hide("百度一下",mode='start')#默认为'start',可省略

win_show

方法名：
win_show(title,*,mode=’start’)

方法描述：
窗口显示

版本信息：
该方法适用于从3.3.0及以上版本。

参数说明：

title : 窗口标题
mode : 窗口匹配模式 ‘start’|’subStr’|’exact’|’reg’
- start:以指定title开始的窗体
- subStr:包含指定title的窗体
- exact:完全匹配指定title的窗体
- reg:title正则匹配指定title的窗体

返回值说明：
无

示例：

# 显示窗口
rpa.win32.win_show("百度一下",mode='start')#默认为'start',可省略

win_exists

方法名：
win_exists(title,*,mode=’start’)

方法描述：
窗口是否存在

版本信息：
该方法适用于从3.3.0及以上版本。

参数说明：

title : 窗口标题
mode : 窗口匹配模式 ‘start’|’subStr’|’exact’|’reg’
- start:以指定title开始的窗体
- subStr:包含指定title的窗体
- exact:完全匹配指定title的窗体
- reg:title正则匹配指定title的窗体

返回值说明：
返回窗口是否存在

示例：

# 判断窗口是否存在
if rpa.win32.win_exists("百度一下",mode='start'):   #默认为'start',可省略
    pass

win_appear

方法名：
win_appear(title,*,timeout=30)

方法描述：
等待窗口出现

版本信息：
该方法适用于从3.3.0及以上版本。

参数说明：

title : 窗口标题
timeout : 等待超时时间

返回值说明：
无

示例：

# 等待窗口出现
rpa.win32.win_appwar("百度一下",timeout=10)：

win_disappear

方法名：
win_disappear(title, *, timeout=30)

方法描述：
等待窗口消失

版本信息：
该方法适用于从3.3.0及以上版本。

参数说明：

title : 窗口标题
timeout : 等待超时时间

返回值说明：
无

示例：

# 等待窗口消失
rpa.win32.win_disappear("百度一下",timeout=10)：

win_close

方法名：
win_close(title,*,mode=’start’)

方法描述：
关闭窗口

版本信息：
该方法适用于从3.3.0及以上版本。

参数说明：

title : 窗口标题
mode : 窗口匹配模式 ‘start’|’subStr’|’exact’|’reg’
- start:以指定title开始的窗体
- subStr:包含指定title的窗体
- exact:完全匹配指定title的窗体
- reg:title正则匹配指定title的窗体

返回值说明：
无

示例：

# 等待窗口消失
rpa.win32.win_close("百度一下",mode='start')#默认为'start',可省略

mouse_click

方法名：
mouse_click(x, y, *, button=’left’, count=1)

方法描述：
鼠标点击

版本信息：
该方法适用于从3.3.0及以上版本。

参数说明：

x : 横坐标
y : 纵坐标
button : ‘left’|’right’ 左键或右键
count : 点击次数

返回值说明：
无

示例：

rpa.win32.mouse_click(100,20)

save_file_dialog

方法名：
save_file_dialog(path,title=’保存文件’)

方法描述：
下载文件弹窗

版本信息：
该方法适用于从3.3.0及以上版本。

参数说明：

path : 下载后的保存路径
title : ‘保存文件’|’保存图片’|’另存为’

返回值说明：
无

示例：

rpa.win32.save_file_dialog(r'D:\',title='保存文件')

open_file_dialog

方法名：
open_file_dialog(path)

方法描述：
上传文件弹窗

版本信息：
该方法适用于从3.3.0及以上版本。

参数说明：

path : 下载后的保存路径

返回值说明：
无

示例：

rpa.win32.open_file_dialog(r'D:\')

cursor_move

方法名：
cursor_move(x, y)

方法描述：
鼠标移动

版本信息：
该方法适用于从3.3.0及以上版本。

参数说明：

x : 横坐标
y : 纵坐标

返回值说明：
无

示例：

rpa.win32.cursor_move(100,20)

key_send

方法名：
key_send(key)

方法描述：
发送按键
使用autoit语法

版本信息：
该方法适用于从3.3.0及以上版本。

参数说明：

key : 按键

返回值说明：
无

示例：

rpa.win32.key_send('{ENTER}')  # 发送enter键
rpa.win32.key_send('^{A}')  # 发送ctrl+A键
rpa.win32.key_send('{F}')  # 发送F键

更多按键参考key_send用法

input

方法名：
input(element, value, *, index=1, simulate=True, parent_element=None, timeout=10)

方法描述：
输入

版本信息：
该方法适用于从3.3.0及以上版本。

参数说明：

element : 控件名称
value : 输入的内容
index : 如果有多个，给出控件下标
simulate : 是否模拟输入
parent_elemet : 父控件对象
timeout : 等待超时时间

返回值说明：
无

示例：

rpa.win32.input('输入框','AAA')

click

方法名：
click(element, *, index=1, simulate=True, parent_element=None, timeout=10)

方法描述：
点击

版本信息：
该方法适用于从3.3.0及以上版本。

参数说明：

element : 控件名称
index : 如果有多个，给出控件下标
simulate : 是否模拟点击
parent_elemet : 父控件对象 <element>
timeout : 等待超时时间

返回值说明：
无

示例：

rpa.win32.click('按钮')

check

方法名：
check(element, *, value=None, index=1, parent_element=None)

方法描述：
勾选框操作

版本信息：
该方法适用于从3.3.0及以上版本。

参数说明：

element : 控件名称
index : 如果有多个，给出控件下标
value : 不给获取勾选状态，传入True则勾选，传入False取消勾选
parent_elemet : 父控件对象 <element>
timeout : 等待超时时间

返回值说明：
无

示例：

result = rpa.win32.check('勾选框')
rpa.win32.check('勾选框',value=True)
rpa.win32.check('勾选框',value=False)

text

方法名：
text(element, *, index=1, parent_element=None)

方法描述：
获取文本

版本信息：
该方法适用于从3.3.0及以上版本。

参数说明：

element : 控件名称
index : 如果有多个，给出控件下标
parent_elemet : 父控件对象

返回值说明：
返回文本

示例：

result = rpa.win32.text('文本')

get_element

方法名：
get_element(element, *, index=1, parent_element=None)

方法描述：
获取控件对象

版本信息：
该方法适用于从3.3.0及以上版本。

参数说明：

element : 控件名称
index : 如果有多个，给出控件下标
parent_elemet : 父控件对象

返回值说明：
返回控件对象

示例：

result = rpa.win32.get_element('按钮')

element_count

方法名：
element_count(element, *, index=0, parent_element=None, timeout=10)

方法描述：
获取控件个数

版本信息：
该方法适用于从3.3.0及以上版本。

参数说明：

element : 控件名称
index : 如果有多个，给出控件下标
parent_elemet : 父控件对象
timeout : 等待超时时间

返回值说明：
返回控件个数

示例：

result = rpa.win32.element_count('按钮')

wait

方法名：
wait(element, *, index=1, timeout=10)

方法描述：
等待加载控件

版本信息：
该方法适用于从3.3.0及以上版本。

参数说明：

element : 控件名称
index : 如果有多个，给出控件下标
timeout : 等待超时时间

返回值说明：
等待加载控件，成功返回元素信息，失败返回None
成功返回元素坐标信息信息，如[{‘y’: 301, ‘x’: 1324}]，失败返回None

示例：

ret = rpa.win32.wait("news", timeout=10)
if ret:
    print('找到元素')
else:
    print('未找到元素')

double_click

方法名：
double_click(element, *, index=1, simulate=True, parent_element=None, timeout=10)

方法描述：
鼠标双击（只用于图像录制）

版本信息：
该方法适用于从3.3.0及以上版本。

参数说明：

element : 控件名称
index : 如果有多个，给出控件下标
timeout : 等待超时时间

返回值说明：
无

示例：

rpa.win32.double_click('按钮')

move

方法名：
move(element, *, index=1, timeout=10)

方法描述：
鼠标移入

版本信息：
该方法适用于从3.3.0及以上版本。

参数说明：

element : 控件名称
index : 如果有多个，给出控件下标
timeout : 等待超时时间

返回值说明：
无

示例：

result = rpa.win32.move('输入框')

pos

方法名：
pos(element, *, index=1, timeout=10)

方法描述：
获取坐标

版本信息：
该方法适用于从3.3.0及以上版本。

参数说明：

element : 控件名称
index : 如果有多个，给出控件下标
timeout : 等待超时时间

返回值说明：
返回坐标x,y

示例：

result = rpa.win32.pos('按钮')

capture

方法名：
capture(file,x1,y1,x2,y2)

方法描述：
屏幕截图

版本信息：
该方法适用于从3.3.0及以上版本。

参数说明：

file : 保存截图完成路径(含文件名)
x1 : 起始横坐标
y1 : 起始纵坐标
x2 : 结束横坐标
y2 : 结束纵坐标

返回值说明：
无

示例：

rpa.win32.capture(r'D:\',0,0,1680,1050)

get_select_items

方法名：
get_select_items(element, *, index=1, parent_element=None)

方法描述：
获取combobox的item

版本信息：
该方法适用于从3.3.0及以上版本。

参数说明：

element : 控件名称
index : 如果有多个，给出控件下标
timeout : 等待超时时间

返回值说明：
返回combobox的item

示例：

rpa.win32.get_select_items("控件")

set_select_item

方法名：
set_select_item(element, text, *, index=1, parent_element=None)

方法描述：
combobox下拉

版本信息：
该方法适用于从3.3.0及以上版本。

参数说明：

element : 控件名称
text : 选项文本
index : 如果有多个，给出控件下标
timeout : 等待超时时间

返回值说明：
无

示例：

rpa.win32.set_select_item("控件","文本")

get_datetimepicker

方法名：
get_datetimepicker(element, *, index=1, parent_element=None)

方法描述：
获取日期控件时间

版本信息：
该方法适用于从3.3.0及以上版本。

参数说明：

element : 控件名称
index : 如果有多个，给出控件下标
timeout : 等待超时时间

返回值说明：
返回日期控件时间

示例：

rpa.win32.get_datetimepicker("控件")

set_datetimepicker

方法名：
set_datetimepicker(element, *, year=1970, month=1, day=1, hour=0,minute=0, second=0, index=1, parent_element=None)

方法描述：
设置日期控件时间

版本信息：
该方法适用于从3.3.0及以上版本。

参数说明：

element : 控件名称
year : 年
month : 月
day : 日
hour : 时
minute : 分
second : 秒
index : 如果有多个，给出控件下标
parent_element : 父控件对象 <element>

返回值说明：
返回日期控件时间

示例：

rpa.win32.set_datetimepicker("控件",2019,2,12,12,11,60)

rpa.win32

目录