IUIAutomationTreeWalker：：NormalizeElementBuildCache 方法 (uiautomationclient.h)

擷取最接近樹狀檢視中指定之 Microsoft UI Automation 元素的上階元素、預先擷取要求的屬性和控制模式，並將預先擷取的專案儲存在快取中。

語法

HRESULT NormalizeElementBuildCache(
  [in]          IUIAutomationElement      *element,
  [in]          IUIAutomationCacheRequest *cacheRequest,
  [out, retval] IUIAutomationElement      **normalized
);

參數

[in] element

類型： IUIAutomationElement*

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

[in] cacheRequest

類型： IUIAutomationCacheRequest*

快取要求的指標，指定要在傳回專案上快取的屬性和控制項模式。

[out, retval] normalized

類型： IUIAutomationElement**

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

傳回值

類型： HRESULT

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

備註

元素的正規化方式是巡覽樹狀結構中的上階鏈結，直到達到先前呼叫 IUIAutomationTreeWalker：：Condition) 所指定的檢視條件 (的專案為止。 如果到達根項目，則會傳回根項目，即使它不符合檢視條件也一樣。

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

需求