# pywinauto.findwindows 提供用于迭代和查找窗口/元素的函数 >[success] *异常* `pywinauto.findwindows.ElementAmbiguousError` 有不止一个元素匹配 >[success] *异常* `pywinauto.findwindows.ElementNotFoundError` 找不到元素 >[success] *异常* `pywinauto.findwindows.WindowAmbiguousError` 不止一个窗口匹配 >[success] *异常* `pywinauto.findwindows.``WindowNotFoundError` 找不到窗口 >[success] `pywinauto.findwindows.enum_windows()` 返回所有顶级窗口的句柄列表 >[success] `pywinauto.findwindows.find_element(kwargs)` 调用find_elements并确保只返回一个元素 使用与调用的参数完全相同的参数调用find_elements，因此请参阅`find_elements()`以获取完整的参数说明。 >[success] `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)` 根据传入的标准查找元素 >[warning] 警告！ 不建议直接使用此功能！ 这是一个非常低级的API。 更好地使用“入门指南”中描述的Application和WindowSpecification对象。 可能的值是： * **class_name** 具有此窗口类的元素 * **class_name_re** 类与此正则表达式匹配的元素 * **parent** 元素是此的子元素 * **process** 在此过程中运行的元素 * **title** 有这个文字的元素 * **title_re** 文本与此正则表达式匹配的元素 * **top_level_only** 仅限顶级元素(默认值=**True**) * **visible_only** 仅可见元素 (默认值=**True**) * **enabled_only** 仅启用元素 (默认值=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表示当前活动后端） >[success] `pywinauto.findwindows.find_window(**kwargs)` 调用find_elements并确保只返回一个元素的句柄 使用与调用的参数完全相同的参数调用find_elements，因此请参阅`find_elements()`以获取完整的参数说明。 >[success] `pywinauto.findwindows.find_windows(**kwargs)` 根据传入的条件查找元素并返回其句柄列表 使用与调用的参数完全相同的参数调用find_elements，因此请参阅`find_elements()`以获取完整的参数说明。