全部产品
云市场

rpa.win32

更新时间:2019-09-18 15:39:20

目录

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

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

窗口最小化

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

窗口最大化

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

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

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

窗口显示

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

窗口是否存在

  • title : 窗口标题

  • mode : 窗口匹配模式 ‘start’|’subStr’|’exact’|’reg’

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

返回bool

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

win_appear

win_appear(title, *, timeout=30)

等待窗口出现

title : 窗口标题

timeout : 超时时间

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

win_disappear

win_disappear(title, *, timeout=30)

等待窗口出现

title : 窗口标题

timeout : 超时时间

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

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

mouse_click

mouse_click(x, y, *, button=’left’, count=1)

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

鼠标点击

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

save_file_dialog

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

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

下载文件弹窗

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

open_file_dialog

open_file_dialog(path)

-path : 下载后的保存路径

上传文件弹窗

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

cursor_move

cursor_move(x, y)

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

鼠标移动

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

key_send

key_send(key)

  • key : 按键

发送按键
使用autoit语法

  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)

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

输入

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

click

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

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

点击

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

check

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

  • element : 控件名称
  • index : 如果有多个,给出控件下标
  • value : 不给获取勾选状态,传入True则勾选,传入False取消勾选
  • parent_elemet : 父控件对象
  • 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)

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

获取文本

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

get_element

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

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

获取对象
返回控件对象

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

element_count

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

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

获取控件个数

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

wait

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

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

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

鼠标双击(只用于图像录制)

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

move

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

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

鼠标移入

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

pos

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

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

获取坐标
返回坐标x,y

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

capture

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

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

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

获取combobox的item

  1. rpa.win32.get_select_items("控件")

set_select_item

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

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

combobox下拉

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

get_datetimepicker

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

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

获取日期控件时间

  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)

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

设置日期控件时间

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