win32

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

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

win_activate

win_activate(title,*,mode=’start’)

激活窗口

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’)

窗口最小化

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’)

窗口最大化

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’)

窗口隐藏，在任务栏不显示

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’)

窗口显示

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’)

窗口是否存在

title : 窗口标题
mode : 窗口匹配模式 ‘start’|’subStr’|’exact’|’reg’

start:以指定title开始的窗体
subStr:包含指定title的窗体
exact:完全匹配指定title的窗体
reg:title正则匹配指定title的窗体

返回bool

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

win_appear

win_appear(title, *, timeout=30)

等待窗口出现

title : 窗口标题

timeout : 超时时间

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

win_disappear

win_disappear(title, *, timeout=30)

等待窗口出现

title : 窗口标题

timeout : 超时时间

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

win_close

win_close(title,*,mode=’start’)

关闭窗口

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)

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

鼠标点击

rpa.win32.mouse_click(100,20)

save_file_dialog

save_file_dialog(path,title=’保存文件’)

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

下载文件弹窗

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

open_file_dialog

open_file_dialog(path)

-path : 下载后的保存路径

上传文件弹窗

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

cursor_move

cursor_move(x, y)

x : 横坐标
y : 纵坐标

鼠标移动

rpa.win32.cursor_move(100,20)

key_send

key_send(key)

key : 按键

发送按键
使用autoit语法

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)

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

输入

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

click

click(element, *, index=1, simulate=True, parent_element=None, timeout=10)

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

点击

rpa.win32.click('按钮')

check

check(element, *, value=None, index=1, parent_element=None)

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)

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

获取文本

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

get_element

get_element(element, *, index=1, parent_element=None)

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

获取对象
返回控件对象

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

element_count

element_count(element, *, index=0, parent_element=None, timeout=10)

element : 控件名称
index : 如果有多个，给出控件下标
parent_elemet : 父控件对象 <element >
timeout : 超时时间单位秒

获取控件个数

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

wait

wait(element, *, index=1, timeout=10)

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)

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

鼠标双击（只用于图像录制）

rpa.win32.double_click('按钮')

move

move(element, *, index=1, timeout=10)

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

鼠标移入

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

pos

pos(element, *, index=1, timeout=10)

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

获取坐标
返回坐标x,y

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

capture

capture(file,x1,y1,x2,y2)

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)

element : 控件
index : 如果有多个，给出控件下标
parent_element : 父控件对象 <element >

获取combobox的item

rpa.win32.get_select_items("控件")

set_select_item

set_select_item(element, text, *, index=1, parent_element=None)

element : 控件
text : 选项文本
index : 如果有多个，给出控件下标
parent_element : 父控件对象 <element >

combobox下拉

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

get_datetimepicker

get_datetimepicker(element, *, index=1, parent_element=None)

element : 控件
index : 如果有多个，给出控件下标
parent_element : 父控件对象 <element >

获取日期控件时间

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)

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

设置日期控件时间

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

rpa.win32

目录