IUIAutomationTreeWalker::NormalizeElement 方法 (uiautomationclient.h)

擷取最接近樹狀檢視中指定 Microsoft 消費者介面自動化 元素的上階專案。

語法

HRESULT NormalizeElement(
  [in]          IUIAutomationElement *element,
  [out, retval] IUIAutomationElement **normalized
);

參數

[in] element

類型: IUIAutomationElement*

要從中開始正規化之專案的指標。

[out, retval] normalized

類型: IUIAutomationElement**

接收最接近樹狀檢視中指定專案之上階專案的指標。

傳回值

類型: HRESULT

如果此方法成功,則會傳回 S_OK。 否則,它會傳回 HRESULT 錯誤碼。

備註

元素的正規化方式是巡覽樹狀結構中的上階鏈結,直到達到先前呼叫 IUIAutomationTreeWalker::Condition) 所指定的檢視條件 (的專案為止。 但首先,傳遞的專案會經過測試,以查看它是否符合正規化條件。 如果是,則會傳回傳遞的專案,即使它不是上階也一樣。

如果找不到相符的專案 此方法會傳回UIA_E_ELEMENTNOTAVAILABLE。

這個方法適用于透過點擊測試取得消費者介面自動化元素參考的應用程式。 應用程式可能只想要使用特定類型的專案,而且可以使用 IUIAutomationTreeWalker::Normalize 來確保無論一開始擷取哪些元素 (,當捲軸取得輸入焦點) 時,最終只會擷取感興趣的專案 (例如內容元素) 。

規格需求

   
最低支援的用戶端 Windows 7、Windows Vista SP2 和 Platform Update for Windows Vista、Windows XP 含 SP3 和適用于 Windows Vista 的平臺更新 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 R2、Windows Server 2008 SP2 和 Platform Update for Windows Server 2008、Windows Server 2003 SP2 和 Platform Update for Windows Server 2008 [僅限桌面應用程式]
目標平臺 Windows
標頭 uiautomationclient.h (包含 UIAutomation.h)