前言

- Pywinauto工具简介
   pywinauto 是一个 Python 库，专门用于自动化 Windows GUI。它允许开发者通过编程控制和操作 Windows 应用程序的界面，包括点击按钮、输入文本、获取控件信息等。pywinauto 支持传统的窗口应用（Win32应用）以及现代的桌面应用程序（例如 WPF 或 UWP）。它的核心优势在于简化了自动化测试和操作过程，尤其适用于需要重复操作的 Windows 程序。

- Windows元素定位工具：Inspect
   Inspect 是一个由 Microsoft 提供的工具，专门用于检查 Windows 应用程序的 UI 元素。它可以让开发者查看和获取界面中每个控件的详细信息，包括控件的属性（如名称、类型、状态）及其在界面中的位置。开发者可以利用这些信息，帮助 pywinauto 定位和操作目标控件。Inspect 主要用于辅助开发人员识别元素，特别是在测试和自动化脚本中非常实用。

- Windows元素定位工具：Spy++
   Spy++ 是 Microsoft Visual Studio 附带的工具，用于捕获和显示 Windows 应用程序的消息和元素。它能够实时跟踪应用程序中的窗口和控件，并提供详细的消息传递和元素层次结构。与 Inspect 类似，Spy++ 也帮助开发者分析和调试应用界面，找出元素的 ID、类名等信息。它特别适合于需要深入了解应用程序消息和控件结构的开发者。

- 演示程序：Xshell 6

CSDN下载链接: https://download.csdn.net/download/qq_45664055/90839608

Pywinauto中文文档: https://www.kancloud.cn/gnefnuy/pywinauto_doc/1193035

---

一、Pywinauto基础

• 安装指定版本或最新版本：pip3 install pywinauto==0.6.8

1、启动程序方法

from pywinauto.application import Application

# 启动应用程序，并使用 UI 自动化的 UIAutomation（uia）后端
# Application(backend="uia") 通过指定 backend 参数来选择使用哪种后端进行 UI 控件的操作。
# backend 参数可以设置为以下几种方法：
# 1. "win32" - 使用经典的 Win32 后端，适用于传统的 Windows 应用程序
# 2. "uia" - 使用 UIAutomation 后端，适用于支持 UIAutomation 的现代 Windows 应用程序
app = Application(backend="uia").start(r"C:\Install\Xshell7\Xshell.exe")

2、获取应用程序窗口名称

方法一：获取当前所有打开的应用窗口名称

from time import sleep
from pywinauto.application import Application
from pywinauto import Desktop

app = Application(backend="uia").start(r"C:\Install\Xshell7\Xshell.exe")

# 等待软件启动
sleep(5)

# 获取当前桌面上的所有窗口
windows = Desktop(backend="uia").windows()
# 打印每个窗口的名称
for window in windows:
    print(window.window_text())

方法二：通过 Inspect 查看

3、连接到已运行的应用程序

• 如果应用程序已经在运行中，可以使用 connect() 方法来连接到它

app = Application(backend="uia").connect(title="Xshell 6 (Free for Home/School)")

---

二、元素定位与控件操作

1、查看程序所有控件参数

from pywinauto.application import Application

app = Application(backend="uia").start(r"C:\Install\Xshell7\Xshell.exe")

# 获取标题为 "Xshell 6 (Free for Home/School)" 的窗口实例，用于后续操作
window = app.window(title="Xshell 6 (Free for Home/School)")

# 两种方法：
# 打印窗口控件的标识符，并返回控件层级结构
# 参数：
# depth: 控件层级的深度，None 表示无限深度，限制深度可以帮助缩小搜索范围。
# filename: 将控件标识符输出到指定的文件，None 表示不输出到文件，直接打印到控制台。
window.print_control_identifiers(depth=None, filename="control_identifiers.txt")

# 打印窗口控件的树形结构，并返回控件层级信息
window.dump_tree(depth=2, filename=None)

# 总结：print_control_identifiers 侧重于控件的标识符，dump_tree 侧重于控件的层级关系

2、获取指定控件相关信息

from pywinauto.application import Application

app = Application(backend="uia").start(r"C:\Install\Xshell7\Xshell.exe")
window = app.window(title="Xshell 6 (Free for Home/School)")
button = window.child_window(title="新建", control_type="Button")
button.click()
edit = window.child_window(title="名称(N):", auto_id="1028", control_type="Edit")

print("控件名称:", edit.element_info.name)
print("控件类名:", edit.element_info.class_name)
print("控件类型:", edit.element_info.control_type)
print("控件自动化ID:", edit.element_info.automation_id)
print("控件是否启用:", edit.is_enabled())
print("控件的父控件:", edit.parent())

3、元素定位

• 通过 Inspect 和 print_control_identifiers 组合获取控件信息，先通过 Inspect 定位到你想要操作的控件，然后通过 print_control_identifiers 获取所有控件 ，再 control_identifiers.txt 中查找控件

1、启用红框中的按钮，然后鼠标拖到 新建 控件上

2、通过 print_control_identifiers 获取所有控件，在 control_identifiers.txt 查找 新建 控件（如果有多个 新建 控件，就在 Inspect 中查找相关的参数，去定位到指定位置）

3、通过child_window(title=“新建”, control_type=“Button”) 定位元素

4、常见的 control_type 类型

• control_type 是 pywinauto 中用来识别和区分 UI 元素类型的属性。每个控件都有一个唯一的 control_type，可以用来帮助你在自动化操作中找到并与特定的 UI 元素进行交互

--------------------------------
Button - 按钮控件
--------------------------------
TextBox - 文本框控件
--------------------------------
ComboBox - 下拉框控件
--------------------------------
Edit - 编辑控件（例如，文本输入框）
--------------------------------
CheckBox - 复选框控件
--------------------------------
RadioButton - 单选按钮控件
--------------------------------
List - 列表控件
--------------------------------
Window - 窗口控件
--------------------------------
Pane - 面板控件
--------------------------------
Image - 图片控件
--------------------------------
Menu - 菜单控件
--------------------------------
MenuItem - 菜单项控件
--------------------------------
Tab - 标签控件
--------------------------------

---

三、常用操作方法

1、点击操作

from pywinauto.application import Application

app = Application(backend="uia").start(r"C:\Install\Xshell7\Xshell.exe")
window = app.window(title="Xshell 6 (Free for Home/School)")

# click() 标准的点击方法; click_input() 模拟更为真实的用户点击输入行为，适合处理更复杂的点击场景
button = window.child_window(title="新建", control_type="Button")
button.click()
# 以上点击方法报错时，使用以下方法
# button.click_input()

2、输入操作

edit = window.child_window(title="名称(N):", auto_id="1028", control_type="Edit")
edit.type_keys("软件测试服务器")

3、清空操作

edit_1 = window.child_window(title="名称(N):", auto_id="1028", control_type="Edit")
edit_1.set_text('')

4、关闭应用窗口

app.kill()  # 强制关闭应用

5、下拉框选择（示例一）

from pywinauto.application import Application

app = Application(backend="uia").start(r"C:\Install\Xshell7\Xshell.exe")
window = app.window(title="Xshell 6 (Free for Home/School)")
button = window.child_window(title="新建", control_type="Button")
button.click()

# 找到 ComboBox 下拉框，下拉框需要点击才会显示下拉列表数据
combo_box = window.child_window(title="协议(P):", auto_id="541", control_type="ComboBox")

# 图片一数据
# window.print_control_identifiers(depth=None, filename="control_identifiers.txt")

# 下拉列表数据不打开是无法获取到的，需要先点击下拉框，然后通过print_control_identifiers获取数据再定位
button_1 = combo_box.child_window(title="打开", auto_id="DropDown", control_type="Button")
button_1.click()

# 图片二数据
# window.print_control_identifiers(depth=None, filename="control_identifiers.txt")

# 定位到名为 "SFTP" 的 ListItem 控件
list_item = window.child_window(title="SFTP", control_type="ListItem")
# 点击该项, 这里点击只支持click_input()方法，click()方法会报错
list_item.click_input()

---

6、下拉框选择（示例二）

# 下拉框示例程序，直接运行或打包成EXE都可以
import tkinter as tk

# 创建主窗口
root = tk.Tk()
root.title("下拉列表选择框")
root.geometry("300x200+630+80")

# 下拉列表的选项数据
options = ["选项1", "选项2", "选项3", "选项4", "选项5"]

# 创建一个变量来保存选择的值
selected_option = tk.StringVar()
selected_option.set(options[0])  # 默认选中第一个选项

# 创建下拉列表（OptionMenu）
dropdown = tk.OptionMenu(root, selected_option, *options)
dropdown.pack(pady=20)  # 添加到窗口并设置间距

# 启动主循环
root.mainloop()

# 操作下拉框程序
from pywinauto.application import Application
# import subprocess
# import time

# 启动 EXE 文件
# subprocess.Popen(["test1.exe"])
# time.sleep(3)

# 程序标题
app = Application(backend="uia").connect(title="下拉列表选择框")
window = app.window(title="下拉列表选择框")
# 第一次获取控件
# window.print_control_identifiers()
pane2 = window.child_window(best_match="Pane2", control_type="Pane")
pane2.click_input()

# 下拉列表数据窗口标题
list_data = Application(backend="uia").connect(title="上下文").window(title="上下文")
# 第二次获取控件
# list_data.print_control_identifiers()
menu_item = list_data.child_window(auto_id="2", control_type="MenuItem")
menu_item.click_input()

---

四、等待与同步

1、wait 方法

主要用法：
  1. 等待控件可见或可操作
   wait 方法会阻塞代码执行，直到满足给定的条件（如控件可见、可点击等）

  2. 常见的等待条件：
   visible: 等待控件变得可见
   exists: 等待控件存在
   enabled: 等待控件可用
   ready: 等待控件处于准备好进行交互的状态

from pywinauto.application import Application


app = Application(backend="uia").start(r"C:\Install\Xshell7\Xshell.exe")
window = app.window(title="Xshell 6 (Free for Home/School)")


button = window.child_window(title="新建", control_type="Button")
button.click()

# 通过这个勾选框模拟输入框是否可用
# check_box = window.child_window(title="连接异常关闭时自动重新连接(A) ", auto_id="1632", control_type="CheckBox")
# check_box.click()

# 处理超时异常
try:
    # 输入框
    edit = window.child_window(title="间隔(V): ", auto_id="1631", control_type="Edit")
    edit.wait('enabled', timeout=5)  # 等待5秒
    edit.type_keys(2)

except Exception as e:
    print(f"错误：{e}")