Python PC 端自动化测试实战教程-5-pywinauto 操作 PC 端应用程序窗口 - 下篇(详细教程)

北京-宏哥 · December 01, 2025 · 120 hits

1.简介

上一篇宏哥主要讲解和介绍了如何获取 PC 端应用程序窗口信息和如何连接窗口对其进行操作的常用的几种方法。今天宏哥接着讲解和分享一下窗口的基本操作:最大化、最小化、恢复正常、关闭窗口、获取窗口状态和获取窗口坐标。以及窗口的其他打开方法和选择方法。

2.窗口的基本操作

窗口的一些基本操作方法:

  • 最大化 :w.maximize()
  • 最小化 :w.minimize()
  • 恢复正常 :w.restore()
  • 关闭窗口: w.close()
  • 获取窗口状态: w.get_show_state() 返回 1 最大化, 0 正常,2 最小化
  • 获取窗口坐标: w.rectangle() 返回 (L35, T149, R1544, B913)

2.1 代码设计

2.2 参考代码

# -*- coding:utf-8 -*-

# 1.先设置编码,utf-8可支持中英文,如上,一般放在第一行

# 2.注释:包括记录创建时间,创建人,项目名称。
'''
Created on 2025-12-01
@author: 北京-宏哥
北京宏哥(微信搜索:北京宏哥,关注宏哥,提前解锁更多测试干货!)
Project: PC端自动化测试实战教程-5-pywinauto 操作PC端应用程序窗口(详细教程)-下篇
'''

# 3.导入模块
from pywinauto import Application
import time

# 通过窗口打开
app = Application('uia').start("D:/software/Notepad/Notepad++/notepad++.exe")
app = Application('uia').connect(class_name="Notepad++")
# win = app['窗口的标题']
win = app['新文件1 - Notepad++']
win.type_keys("北京-宏哥")
time.sleep(2)
win.maximize()   # 最大化
time.sleep(2)
win.restore()    # 恢复
time.sleep(2)
win.minimize()   # 最小化
# win.close()      # 关闭

2.3 运行代码

1.运行代码,右键 Run'Test',就可以看到控制台输出,如下图所示:

2.运行代码后电脑端的动作(启动记事本)。如下图所示:

3.窗口打开方法

前面是通过窗口的的标题操作打开的窗口,再介绍一个最简单的方法是 top_window(),例如:宏哥这里还是演示打开 notepad++ 编辑器。

3.1 代码设计

3.2 参考代码

# -*- coding:utf-8 -*-

# 1.先设置编码,utf-8可支持中英文,如上,一般放在第一行

# 2.注释:包括记录创建时间,创建人,项目名称。
'''
Created on 2025-12-01
@author: 北京-宏哥
北京宏哥(微信搜索:北京宏哥,关注宏哥,提前解锁更多测试干货!)
Project: PC端自动化测试实战教程-5-pywinauto 操作PC端应用程序窗口(详细教程)-下篇
'''

# 3.导入模块
from pywinauto import Application
import time

from pywinauto import Application
import time
app = Application('uia').start("D:/software/Notepad/Notepad++/notepad++.exe")
# time.sleep(3)
dlg = app.top_window()
print(dlg)

3.3 运行代码

1.运行代码,右键 Run'Test',就可以看到控制台输出,如下图所示:

2.运行代码后电脑端的动作(启动 notepad++ 编辑器)。如下图所示:

以上方法将返回具有应用程序顶级窗口的最高顺序的窗口。

注意: 它返回的是是应用程序的顶级窗口,如果窗口有覆盖的情况,那么你可以使用与传递给 findwindows.find_windows() 相同的参数,例如:

dlg = app.window(title_re="Page Setup", class_name="#32770")

如果对话框的标题很长 - 那么输入的属性访问可能会很长,在这种情况下通常更容易使用

app.window(title_re=".*部分标题.*")

获取当前应用全部 windows

dialogs = app.windows()

这将返回应用程序的所有可见,启用的顶级窗口的列表。

总结:推荐使用 app.window(title_re="xxx") 方法操作指定窗口。

4.小结

4.1 遇到的坑

在演示的过程中,想必细心的小伙伴或者童鞋们已经发现宏哥代码在窗口最小化之后,将窗口关闭的代码注释掉了,这是因为宏哥在演示的时候,直接报错:​pywinauto.findbestmatch.MatchError: Could not find '新文件 1 - Notepad++' in 'dict_keys([])'​,本来宏哥觉得最小化之后,加上一段恢复窗口,再关闭就可以了,结果还是报一样的错误。因为一时没有好的解决办法,由于时间的关系,宏哥就将那段关闭窗口的代码注释掉了。如下图所示:

解决办法:经过查找资料和百度还是没有什么好的解决办法,宏哥突然想到之前文章中提到过的访问技术是否正确,uia 报错,就换 win32。否则就会报错找不到元素。因此宏哥抱着试一下心态,结果成功了。

4.1.1 代码设计

4.1.2 参考代码

# -*- coding:utf-8 -*-

# 1.先设置编码,utf-8可支持中英文,如上,一般放在第一行

# 2.注释:包括记录创建时间,创建人,项目名称。
'''
Created on 2025-12-01
@author: 北京-宏哥
北京宏哥(微信搜索:北京宏哥,关注宏哥,提前解锁更多测试干货!)
Project: PC端自动化测试实战教程-5-pywinauto 操作PC端应用程序窗口(详细教程)-下篇
'''

# 3.导入模块
from pywinauto import Application
import time

# 通过窗口打开
app = Application('win32').start("D:/software/Notepad/Notepad++/notepad++.exe")
app = Application('win32').connect(class_name="Notepad++")
# win = app['窗口的标题']
win = app['新文件1 - Notepad++']
win.type_keys("北京-宏哥")
time.sleep(2)
win.maximize()   # 最大化
time.sleep(2)
win.restore()    # 恢复
time.sleep(2)
win.minimize()   # 最小化
win.restore()    # 恢复
win.close()      # 关闭

4.1.3 运行代码

1.运行代码,右键 Run'Test',就可以看到控制台输出,如下图所示:

2.运行代码后电脑端的动作(正常运行,由告警是 32 位和 64 位 python 的告警)。如下图所示:

4.2pywinauto 中的 uia 是什么意思?

在 pywinauto 库中,uia 指的是 UI Automation,这是 Windows 操作系统提供的一种技术框架,用于实现用户界面 (UI) 的自动化测试和辅助功能访问。UI Automation 是微软从 Windows Vista 开始引入的核心技术,旨在为所有 UI 元素提供一致的编程接口,无论这些元素是由何种技术(如 Win32、WPF、UWP 等)实现的。

在 pywinauto 中,通过指定 backend="uia",用户可以选择使用 UI Automation 作为底层引擎来与应用程序的 UI 元素进行交互。这为自动化测试提供了更广泛的支持,尤其是在处理现代 Windows 应用(尤其是使用 WPF 和 UWP 技术构建的应用)时更为有效。UI Automation 后端相比传统的 win32 后端,提供了更丰富和高级的元素属性、控制模式(Control Patterns)以及事件支持,使得自动化脚本可以更加灵活和强大。

使用 UI Automation 后端,开发者可以更容易地定位和操作 UI 元素,如获取元素的属性、模拟鼠标和键盘操作、监听 UI 事件等,这对于创建复杂的自动化测试场景尤其有用。

好了,关于 操作 PC 端应用程序窗口基本操作非常简单,时间不早了今天就分享到这里,感谢你耐心地阅读!

No Reply at the moment.
需要 Sign In 后方可回复, 如果你还没有账号请点击这里 Sign Up