pywinauto 项目技术文档

最新推荐文章于 2025-05-16 19:56:22 发布

原创最新推荐文章于 2025-05-16 19:56:22 发布 · 982 阅读

CC 4.0 BY-SA版权

pywinauto 项目技术文档

pywinauto pywinauto/pywinauto: 一个 Python 库，用于自动化 Windows 应用程序。特点是提供了丰富的函数和类库，可以用于控制鼠标、键盘和菜单等元素，实现自动化任务。项目地址: https://gitcode.com/gh_mirrors/py/pywinauto

1. 安装指南

1.1 使用 pip 安装

pywinauto 可以通过 pip 工具进行安装。打开命令行界面，运行以下命令：

pip install -U pywinauto

该命令会自动安装 pywinauto 及其依赖项。

1.2 手动安装依赖项

如果需要手动安装依赖项，请根据操作系统的不同进行安装：

Windows

Linux

1.3 可选依赖项

为了使用 capture_as_image() 方法进行控件截图，建议安装 Pillow 库：

pip install -U Pillow

1.4 运行单元测试

为了确保安装正确，可以运行单元测试。首先安装测试所需的依赖项：

然后运行以下命令：

python ./pywinauto/unittests/testall.py

2. 项目使用说明

2.1 基本概念

pywinauto 是一个用于自动化 Microsoft Windows GUI 的 Python 模块。它允许你发送鼠标和键盘操作到窗口对话框和控件，并支持更复杂的操作，如获取文本数据。

2.2 支持的技术

Win32 API (backend="win32")：默认后端，适用于大多数 Windows 应用程序。
MS UI Automation (backend="uia")：适用于更复杂的 UI 自动化需求。

2.3 用户输入模拟

mouse 和 keyboard 模块可以在 Windows 和 Linux 上工作，用于模拟用户输入。

3. 项目 API 使用文档

3.1 启动应用程序

使用 Application 类启动应用程序：

from pywinauto.application import Application
app = Application().start("notepad.exe")

3.2 操作菜单

选择菜单项：

app.UntitledNotepad.menu_select("Help->About Notepad")

3.3 点击按钮

点击对话框中的按钮：

app.AboutNotepad.OK.click()

3.4 输入文本

在编辑框中输入文本：

app.UntitledNotepad.Edit.type_keys("pywinauto Works!", with_spaces = True)

3.5 MS UI Automation 示例

以下是一个使用 MS UI Automation 后端的示例：

from pywinauto import Desktop, Application

Application().start('explorer.exe "C:\\Program Files"')

# 连接到由 explorer.exe 启动的另一个进程
app = Application(backend="uia").connect(path="explorer.exe", title="Program Files")

app.ProgramFiles.set_focus()
common_files = app.ProgramFiles.ItemsView.get_item('Common Files')
common_files.right_click_input()
app.ContextMenu.Properties.invoke()

# 此对话框在另一个进程中打开（Desktop 对象不依赖于任何进程 ID）
Properties = Desktop(backend='uia').Common_Files_Properties
Properties.print_control_identifiers()
Properties.Cancel.click()
Properties.wait_not('visible') # 确保对话框已关闭