pywinauto所有属性和方法

qh0526wy

已于 2024-06-20 22:50:33 修改

阅读量736

点赞数 3

分类专栏： RPA Python 文章标签： rpa python

于 2024-06-20 15:41:43 首次发布

本文链接：https://blog.csdn.net/qh0526wy/article/details/139834630

版权

Python 同时被 2 个专栏收录

68 篇文章

订阅专栏

RPA

8 篇文章

订阅专栏

pywinauto 是一个强大的库，它提供了许多方法和属性来与 Windows GUI 应用程序进行交互。以下是一些 pywinauto 的主要方法和属性：

Application 类的主要方法和属性:

start(path [, timeout, retry_interval]): 启动应用程序。
- 方法定义：
```
Application().start(path, timeout=None, retry_interval=5, working_dir=None)
```
  参数说明：
  - path: 要启动的应用程序的路径或命令行。对于 .exe 文件，可以直接提供文件路径；对于命令行程序，可以提供命令行字符串。
  - timeout: 等待应用程序启动的超时时间（秒）。如果应用程序在指定时间内没有启动，将引发超时异常。
  - retry_interval: 重试间隔时间（秒）。在等待应用程序启动期间，如果应用程序没有响应，pywinauto 将等待此时间后再次尝试。
  - working_dir: 应用程序的工作目录。如果提供，应用程序将在指定目录下启动。
- 使用示例：
```
from pywinauto.application import Application # 启动记事本程序 
app = Application().start('notepad.exe') # 启动应用程序并指定工作目录 
app = Application().start('your_app.exe', working_dir=r'C:\YourAppDirectory')
```
  注意事项：
  - 使用 start 方法时，确保提供的应用程序路径是正确的，且应用程序具有可执行权限。
  - 如果应用程序需要在特定的工作目录下运行，可以设置 working_dir 参数。
  - timeout 参数对于确保应用程序在合理的时间内启动很有用，特别是在自动化脚本中。
  - pywinauto 将返回一个 Application 对象，你可以通过这个对象进一步操作应用程序的窗口和控件。
- start 方法是 pywinauto 中自动化应用程序操作的起点，通过它你可以启动应用程序并进行后续的窗口和控件操作。
connect(path=None, process=None, handle=None, timeout=None): 连接到已运行的应用程序。
- 方法定义：
```
Application().connect(title=None, process=None, path=None, handle=None, timeout=None, retry_interval=5)
```
  参数说明：
  - title: 要连接的窗口的标题。如果提供了标题，pywinauto 将尝试找到匹配的窗口。
  - process: 应用程序的进程ID或进程对象。如果提供了进程ID，pywinauto 将连接到该进程。
  - path: 应用程序的可执行文件路径。如果提供了路径，pywinauto 将尝试找到已启动的该应用程序的实例。
  - handle: 窗口的句柄。如果提供了窗口句柄，pywinauto 将直接连接到该窗口。
  - timeout: 等待连接的超时时间（秒）。如果在指定时间内未能连接到应用程序，将引发超时异常。
  - retry_interval: 重试间隔时间（秒）。在尝试连接期间，如果连接失败，pywinauto 将等待此时间后再次尝试。
- 使用示例：
```
from pywinauto.application import Application

# 通过窗口标题连接到已运行的应用程序
app = Application().connect(title="已运行应用程序的窗口标题")

# 通过进程ID连接到应用程序
app = Application().connect(process=1234)

# 通过窗口句柄连接到应用程序
app = Application().connect(handle=窗口句柄值)
```
  注意事项：
- 使用 connect 方法时，你可以根据需要提供 title、process、path 或 handle 中的任何一个或多个参数。pywinauto 将根据这些参数尝试连接到应用程序。
- 如果应用程序有多个窗口具有相同的标题，使用 title 参数可能会连接到其中一个窗口。如果需要特定的窗口，可以使用更具体的标识符。
- timeout 参数对于确保在自动化脚本中应用程序在合理的时间内响应连接请求很有用。
- connect 方法返回的 Application 对象可以用于进一步操作应用程序的窗口和控件。
- connect 方法是 pywinauto 中与现有应用程序交互的重要手段，特别适用于需要对已经运行的应用程序进行自动化操作的场景。
top_window(): 获取应用的顶层窗口。
window(title=None, title_re=None, class_name=None, best_match=False): 获取单个窗口。
windows(title=None, title_re=None, class_name=None): 获取所有匹配条件的窗口列表。
is64bit(): 检查应用程序是否为64位。
cpu_usage(interval): 检查应用程序的CPU使用率。
wait_cpu_usage_lower(threshold, timeout): 等待CPU使用率低于指定阈值。
active(): 搜索并返回一个激活的窗口。
kill(soft=True): 结束应用程序的进程。
wait_for_process_exit(timeout, retry_interval): 等待应用程序进程结束。

Window 类的主要方法和属性:

title: 获取窗口的标题。
best_match(title): 根据标题获取最佳匹配的窗口。
close(force=False): 关闭窗口。
restore(): 还原窗口到原始大小和位置。
set_focus(): 将焦点设置到窗口。
wait('visible', timeout): 等待窗口变为可见。
wait('ready', timeout): 等待窗口准备好。
wait('active', timeout): 等待窗口变为活跃。
menu_select(menu_item, *args): 选择菜单项。
type_keys(keys, with_spaces=True): 在窗口中键入文本。
press_keys(key_spec): 模拟键盘按键。

Desktop 类的主要方法:

Desktop(backend): 获取桌面对象，用于跨进程操作。

其他控件类的主要方法和属性:

控件类如 Button, Edit, List, ComboBox 等，具有自己的特定方法和属性，例如：
- click(): 点击控件。
- click_input(): 点击并输入。
- double_click(): 双击控件。
- right_click(): 右键点击控件。
- type_keys(): 在控件中输入文本。
- select(item): 选择列表中的项。
- get_text(): 获取控件中的文本。