findwindows 用户模块类
提供用于迭代和查找窗口/元素的函数
exception pywinauto.findwindows.ElementAmbiguousError
匹配的元素不止一个
exception pywinauto.findwindows.ElementNotFoundError
找不到任何元素
exception pywinauto.findwindows.WindowAmbiguousError
匹配的窗口不止一个
exception pywinauto.findwindows.WindowNotFoundError
找不到窗口
findwindows.enum_windows
pywinauto.findwindows.enum_windows()
返回所有顶级窗口的句柄列表
findwindows.find_element
pywinauto.findwindows.find_element(**kwargs)
调用 find_elements 并确保只返回一个元素
调用 find_elements 的参数与调用的参数完全相同,因此请参阅 find_elements()
完整的参数说明。
findwindows.find_elements
pywinauto.findwindows.find_elements(class_name=None,
class_name_re=None,
parent=None,
process=None,
title=None,
title_re=None,
top_level_only=True,
visible_only=True,
enabled_only=False,
best_match=None,
handle=None,
ctrl_index=None,
found_index=None,
predicate_func=None,
active_only=False,
control_id=None,
control_type=None,
auto_id=None,
framework_id=None,
backend=None,
depth=None
)
根据传入的条件查找元素
警告!不建议直接使用此功能!这是一个非常低级的 API。更好地使用入门指南中描述的 Application 和 WindowSpecification 对象。
可能的参数为:
参数 | 说明 |
---|---|
class_name | 具有此窗口类的元素 |
class_name_re | 类与此正则表达式匹配的元素 |
parent | 元素是 this 的子元素 |
process | 此进程的 ID |
title | 包含此文本的元素 |
title_re | 文本与此正则表达式匹配的元素 |
top_level_only | 仅限顶级元素 (默认值 True) |
visible_only | 仅可见元素 (默认值 True) |
enabled_only | 仅限 Enabled 元素 (默认值 False) |
best_match | 标题与此类似的元素 |
handle | 要返回的元素的句柄 |
ctrl_index | 要返回的子元素的索引 |
found_index | 要返回的筛选掉的子元素的索引 |
predicate_func | 用户提供的用于自定义元素验证的钩子 |
active_only | 仅限活动元素 (默认值 False) |
control_id | 具有此控件 ID 的元素 |
control_type | 具有此控件类型的元素(字符串;用于 UIAutomation 元素) |
auto_id | 具有此自动化 ID 的元素(用于 UIAutomation 元素) |
framework_id | 具有此框架 ID 的元素(用于 UIAutomation 元素) |
backend | 搜索时使用的后端名称(默认值 None 表示当前活动后端) |
findwindows.find_window
pywinauto.findwindows.find_window(**kwargs)
调用find_elements并确保仅返回一个元素的句柄
调用find_elements的参数与调用的参数完全相同,因此请参阅 find_elements()
完整的参数说明。
findwindows.find_windows
pywinauto.findwindows.find_windows(**kwargs)
根据传入的条件查找元素并返回其句柄列表
调用find_elements的参数与调用的参数完全相同,因此请参阅 find_elements()
完整的参数说明。