1.说明
pywinauto是一个用于自动化Python 模块,适合Windows系统的软件(GUI),可以通过Pywinauto遍历窗口(对话框)和窗口里的控件,也可以控制鼠标和键盘输入,所以它能做的事情比之前介绍的pysimplegui更多
2.安装
一般使用pip安装就行了
pip install pywinauto
官网文档:https://pywinauto.readthedocs.io/en/latest/
3.Application
我们要控制软件的第一件事就是启动一个Windows软件,每一个软件(进程)都是一个Application对象
实例化Application对象的时候可以传入一个backend参数,可选值为win32(默认)和 uia
,
win32对应的框架:MFC、VB6、VCL、简单的 WinForms 控件和大多数旧的遗留应用程序
uia对应的框架:WinForms、WPF、商店应用程序、Qt5、浏览器
如果无法知道要测试的软件是属于哪种框架,可以使用 Inspect(对应uia)
和 Spy++(对应win32)
看看,你看哪个显示得更全就选哪个。Inspect和Spy++需要自己安装一下
下面是Application对象的主要方法
方法 | 常用参数 | 说明 |
---|---|---|
start() | cmd_line、timeout、retry_interval | 通过cmd命令启动一个软件(进程) |
connect() | process、handle、path、timeout | 连接一个进程,一般是使用进程号(任务管理器可以看到) |
top_window() | / | 获取应用的顶层窗口 |
window() | title、title_re、class_name、best_match | 获取单个窗口(WindowSpecification) |
windows() | title、title_re、class_name | 获取多个窗口(UIAWrapper) |
is64bit() | / | 是否64位应用 |
cpu_usage | interval | CPU占用率 |
wait_cpu_usage_lower() | threshold、timeout | 等待CPU占率小于某个阈值 |
active()() | / | 搜索返回一个激活的窗口 |
kill() | soft | 结束进程 |
wait_for_process_exit() | timeout、retry_interval | 等待进程结束 |
举例,启动一个微信应用,通过进程号连接,进程号就是在任务管理器里详细信息
看到的PID
from pywinauto import Application
app = Application(backend="uia")
# app.start(r"D:\Program Files (x86)\Tencent\WeChat\WeChat.exe")
app.connect(process=6556)
print("is64bit:", app.is64bit())
print("cpu_usage:", app.cpu_usage())
app.wait_cpu_usage_lower()
# app.active() # 如果指定时间内不激活则报错
print("kill:", app.kill())
print("wait_for_process_exit:", app.wait_for_process_exit())
4.WindowSpecification
我们要获取窗口,一个窗口都是一个WindowSpecification
对象,可以通过Application对象的window()方法获取,参数可以是title、classname或者best_match等,这都可以在inspect.exe上看到,不过需要注意的是inspect看到的Name其实对应的是window()的title参数
WindowSpecification对象常用的方法如下
方法 | 常用参数 | 说明 |
---|---|---|
maximize() | / | 最大化窗口 |
minimize() | / | 最小化窗口 |
restore() | / | 恢复窗口 |
close() | / | 关闭窗口 |
get_show_state() | / | 获取窗口状态,0正常1最大化2最小化 |
was_maximized() | / | 当前是否最大化 |
draw_outline() | colour、thickness | 给窗口画个框以便定位 |
print_control_identifiers() | / | 打印所有子窗口和子元素(会打印出对应的control_type) |
child_window() | title、control_type | 获取子窗口 |
exists() | timeout | 窗口是否存在 |
wait() | wait_for, timeout | 等待窗口变成某个状态(exists、visible、enabled、ready、active) |
wait_not() | wait_for_not, timeout | 等待窗口不处于某个状态(exists、visible、enabled、ready、active) |
举个栗子
dlg = app.window(class_name="WeChatMainWndForPC")
# dlg = app.window(title="微信")
print("get_show_state:", dlg.get_show_state())
print("was_maximized:", dlg.was_maximized())
dlg.print_control_identifiers()
dlg.draw_outline()
dlg.maximize()
dlg.restore()
dlg.minimize()
dlg.close()
5.元素控件
一个窗口里一般都会有各种各样的元素,比如说按钮 (Button)、编辑栏(Edit)、树状视图(Tree View)、复选框(CheckBox)、对话框(Dialog)、工具栏(Toolbar)、状态栏(StatusBar)、列表框(ListBox)、窗格(Pane)、菜单(Menu)、菜单栏(MenuItem)、静态内容(Static)、工具提示(ToolTips)、列表控件(ListView)、单选框(RadioButton)、组合框(ComboBox)、选项卡控件(TabControl)、组框 (GroupBox)、弹出菜单(PopupMenu)、头部(Header)等
因为控件类型太多了不能一个一个学习,但是它们都有一个 element_info
的属性,访问之后会返回一个继承于ElementInfo
的对象(UIAElementInfo或HwndElementInfo),比较重要的属性或方法如下
方法或属性 | 常用参数 | 说明 |
---|---|---|
name | / | 元素的真实名(一般是title) |
visible | / | 元素是否可见 |
rich_text | / | 元素的全名 |
rectangle | / | 返回元素的位置以及宽高 |
class_name | / | 类名 |
enabled | / | 元素是否处于可用状态 |
parent | / | 返回父元素 |
children() | title、title_re、class_name、best_match | 返回符合要求的子元素(列表) |
iter_children() | title、title_re、class_name、best_match | 迭代符合要求的子元素(生成器) |
这些元素除了有element_info
可以获取一些元素的主要信息,它们还都被包装成一个Wrapper,所以也可以学一下BaseWrapper
的常用方法和属性。其实BaseWrapper
的方法基本上都是对ElementInfo
进一步包装,我只列出部分方法,如下表
方法或属性 | 常用参数 | 说明 |
---|---|---|
element_info | / | 返回当前元素的ElementInfo对象 |
from_point() | x、y | 通过坐标查找ElementInfo |
class_name() | / | 类名,实际是调用element_info.class_name |
friendly_class_name() | / | 友好的类名,同上 |
window_text() | / | 元素的文本,实际是调用element_info.rich_text |
is_visible() | / | 元素是否可见,实际是调用element_info.visible |
is_enabled() | / | 元素是否可用,实际是调用element_info.enabled |
rectangle() | / | 元素的位置和宽高,实际是调用element_info.rectangle |
process_id() | / | 进程号,实际是调用element_info.process_id |
draw_outline() | colour、thickness | 给当前元素画个框 |
click_input() | button、coords、double | 鼠标操作,实际是调用mouse模块的_perform_click_input() |
type_keys() | / | 键盘操作,实际是调用keyboard模块的send_keys() |
dlg = app.window(class_name="WeChatMainWndForPC")
list_data = dlg.child_window(title="会话", control_type="List")
for item in list_data:
print(type(item))
element_info = item.element_info
print(type(element_info))
print("window_text:", )
print("rich_text:", element_info.rich_text)
print("name:", element_info.name)
print("visible:", element_info.visible)
print("rectangle:", element_info.rectangle)
print("class_name:", element_info.class_name)
print("enabled:", element_info.enabled)
print("parent:", element_info.parent)
print("children:", element_info.children())
print("iter_children:", element_info.iter_children())
if item.window_text() == "文件传输助手":
item.click_input()
item.type_keys("冰冷的希望")
item.type_keys("{VK_RETURN}")
print()
说明一下,每个控件元素都有对应的Wrapper,所以上面的方法也不一定都用,需要根据实际情况进行测试区分。另外,比较有用的click_input()
和type_keys()
这两个方法分别用于操作鼠标和键盘(输入),下面我会单独拿出来说一下
6.鼠标操作
鼠标点击肯定离不开点击的位置,桌面就是一个坐标,左上角为坐标原点,往右是X轴正向,往下是Y轴正向。pywinauto提供了一个mouse模块用于鼠标操作,最核心的方法是_perform_click_input()
,不过它是一个私有方法,我们调用的是基于它的封装方法,如下表
方法 | 参数 | |
---|---|---|
click() | button、coords | 单击鼠标某个键 |
double_click() | button、coords | 双击鼠标某个键 |
right_click() | coords | 单击鼠标右键 |
move() | coords | 移动鼠标 |
press() | button、coords | 按下鼠标 |
release() | button、coords | 放开鼠标 |
scroll() | coords、wheel_dist | 滚动鼠标滚轮 |
wheel_click() | coords | 单击鼠标滚轮 |
参数说明:
参数button
的默认值都是“left”,即鼠标左键,可选值有left、right、middle、move、wheel、x
参数coords
的默认值都是元组(0, 0),元组里的两个整数分别是X、Y轴的值
参数wheel_dist
表示滚动的距离,大于0是向上滚动,小于0是向下滑动
举个栗子
from pywinauto import Application, mouse
app = Application(backend="uia")
app.connect(process=4352)
dlg = app.window(class_name="WeChatMainWndForPC")
list_data = dlg.child_window(title="会话", control_type="List")
for item in list_data:
if item.window_text() == "文件传输助手":
# item.click_input()
rectangle = item.element_info.rectangle
x = int((rectangle.left + rectangle.right) / 2)
y = int((rectangle.top + rectangle.bottom) / 2)
mouse.click(button='left', coords=(x, y))
time.sleep(1)
mouse.click("right", (x, y))
time.sleep(1)
mouse.move((x - 50, y)) # 往左边移动50个像素
time.sleep(1)
mouse.click(coords=(x, y))
break
7.键盘操作
键盘操作主要是按下键盘上的按键,相关方法在keyboard模块,最最主要的是send_keys()
方法,第一个参数keys
就是我们需要按下的按键,其他参数比如说with_spaces、with_tabs、with_newlines、turn_off_numlock、set_foreground、vk_packet,一看就知道作用,而且都是布尔值,此处不进行举例
pywinauto支持的完整的按键可以在官方文档查看,https://pywinauto.readthedocs.io/en/latest/code/pywinauto.keyboard.html
下面我列举出的是一些比较常用的按键
按键 | 符号 | 说明 |
---|---|---|
Shift | VK_SHIFT | 上档键 |
Ctrl | VK_CONTROL、VK_LCONTROL、VK_RCONTROL | Ctrl键、左右Ctrl键 |
Alt | VK_MENU | Alt键 |
Windows | VK_LWIN、VK_RWIN | 左右win键 |
Space | VK_SPACE | 空格键 |
backspace | BACKSPACE | 退格键 |
enter | ENTER | 回车键 |
esc | ESC | 退出键 |
table | VK_TAB | 制表键 |
left、right、up、down | VK_LEFT、VK_RIGHT、VK_UP、VK_DOWN | 上下左右方向键 |
f1~f24 | VK_F1、VK_F2…VK_F24 | f1到f24 |
capslock | CAPSLOCK | 大写键 |
说明:
1.使用按键时需要搭配大括号,比如说按下回车键是 '{ENTER}' (是字符串)
2.在Windows平台默认是发送虚拟按键的,以VK_
开头的按键,都是指虚拟按钮,如果不想使用虚拟按钮可以把VK_
前缀去掉,把send_keys()的vk_packet
参数改为False
即可
单个按键按下抬起还不够,往往需要组合键,这时候就需要修饰符了,在大括号里可以使用down
、up
控制按键什么时候按下和抬起,如果后面加上数字,表示按下多少次
list_data = dlg.child_window(title="会话", control_type="List")
for item in list_data:
if item.window_text() == "文件传输助手":
item.click_input()
# item.type_keys("冰冷的希望")
send_keys(" ") # 随便输入字符串
send_keys("{VK_CONTROL down} a {VK_CONTROL up}") # 快捷键Ctrl+a(先按下Ctrl,再按下a,最后放开Ctrl)
send_keys("{BACKSPACE}") # 按下退格键删除文本
send_keys("{. 6}") # 按6次小数点
send_keys("冰冷的希望{ENTER}") # 输入文本,按下回车键
当然,很多时候使用down
、up
修饰感觉不够简洁,所以pywinauto还提供了简化写法,使用+
代替{VK_SHIFT}
,使用^
代替{VK_CONTROL}
,使用%
代替{VK_MENU}
send_keys('^a^c') # 按下Ctrl+a之后再按下Ctrl+c,即全选复制
send_keys('+{INS}') # 按下Shift+Ins键
send_keys('%{F4}') # 按下Alt+F4键
如果不想按下按钮,纯属想要输入纯字符串,那就需要取消转义了,注意修饰符和按钮的写法是不一样的
send_keys('{^}a{^}c{%}') # 输入字符串"^a^c%"而不是当成快捷键
send_keys('{{}ENTER{}}') # 输入字符串"{ENTER}"而不是按下回车键