# 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()`以獲取完整的參數說明。