全部产品
云市场

rpa.win32

更新时间:2020-03-03 15:41:44

目录

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的窗体

返回值说明

示例

  1. # 打开了ie浏览器
  2. page = rpa.ie.create("www.baidu.com")
  3. # 激活窗口
  4. 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的窗体

返回值说明

示例

  1. # 最小化窗口
  2. 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的窗体

返回值说明

示例

  1. # 最大化窗口
  2. 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的窗体

返回值说明

示例

  1. # 隐藏窗口
  2. 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的窗体

返回值说明

示例

  1. # 显示窗口
  2. 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的窗体

返回值说明
返回窗口是否存在
示例

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

win_appear

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

方法描述
等待窗口出现

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

参数说明

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

返回值说明

示例

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

win_disappear

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

方法描述
等待窗口消失

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

参数说明

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

返回值说明

示例

  1. # 等待窗口消失
  2. 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的窗体

返回值说明

示例

  1. # 等待窗口消失
  2. 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 : 点击次数

返回值说明

示例

  1. rpa.win32.mouse_click(100,20)

save_file_dialog

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

方法描述
下载文件弹窗

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

参数说明

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

返回值说明

示例

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

open_file_dialog

方法名
open_file_dialog(path)

方法描述
上传文件弹窗

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

参数说明

  • path : 下载后的保存路径

返回值说明

示例

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

cursor_move

方法名
cursor_move(x, y)

方法描述
鼠标移动

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

参数说明

  • x : 横坐标
  • y : 纵坐标

返回值说明

示例

  1. rpa.win32.cursor_move(100,20)

key_send

方法名
key_send(key)

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

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

参数说明

  • key : 按键

返回值说明

示例

  1. rpa.win32.key_send('{ENTER}') # 发送enter键
  2. rpa.win32.key_send('^{A}') # 发送ctrl+A键
  3. 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 : 等待超时时间

返回值说明

示例

  1. 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 : 等待超时时间

返回值说明

示例

  1. 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 : 等待超时时间

返回值说明

示例

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

text

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

方法描述
获取文本

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

参数说明

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

返回值说明
返回文本

示例

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

get_element

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

方法描述
获取控件对象

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

参数说明

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

返回值说明
返回控件对象

示例

  1. 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 : 等待超时时间

返回值说明
返回控件个数

示例

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

wait

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

方法描述
等待加载控件

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

参数说明

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

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

示例

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

double_click

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

方法描述
鼠标双击(只用于图像录制)

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

参数说明

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

返回值说明

示例

  1. rpa.win32.double_click('按钮')

move

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

方法描述
鼠标移入

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

参数说明

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

返回值说明

示例

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

pos

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

方法描述
获取坐标

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

参数说明

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

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

示例

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

capture

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

方法描述
屏幕截图

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

参数说明

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

返回值说明

示例

  1. 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

示例

  1. 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 : 等待超时时间

返回值说明

示例

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

get_datetimepicker

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

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

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

参数说明

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

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

示例

  1. 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>

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

示例

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