UiaNavigate 函式 (uiautomationcoreapi.h)

注意 此函式已被取代。 用戶端應用程式應該改用 Microsoft 使用者介面自動化 元件物件模型 (COM) 介面。

 

在 使用者介面自動化 樹狀結構中巡覽，選擇性地擷取快取的資訊。

語法

HRESULT UiaNavigate(
  [in]  HUIANODE          hnode,
  [in]  NavigateDirection direction,
  [in]  UiaCondition      *pCondition,
  [in]  UiaCacheRequest   *pRequest,
  [out] SAFEARRAY         **ppRequestedData,
  [out] BSTR              *ppTreeStructure
);

參數

[in] hnode

類型： HUIANODE

巡覽開始所在的專案。

[in] direction

類型： NavigateDirection

NavigateDirection 列舉型別的值，指出要從 hnode 巡覽的方向。

[in] pCondition

類型： UiaCondition*

UiaCondition 結構的位址，指定巡覽至的項目必須相符的條件。 使用此參數略過不感興趣的專案。

[in] pRequest

類型： UiaCacheRequest*

UiaCacheRequest 結構的位址，其中包含要快取之資訊的描述。

[out] ppRequestedData

類型： SAFEARRAY**

變數的位址，該變數會接收包含所要求數據的 SAFEARRAY 指標。 這個參數會以未初始化的狀態傳遞。 請參閱＜備註＞。

[out] ppTreeStructure

類型： BSTR*

接收樹狀結構描述之變數的位址。 這個參數會以未初始化的狀態傳遞。 請參閱＜備註＞。

傳回值

類型： HRESULT

如果成功或錯誤值，則傳回S_OK。

備註

樹狀結構是由字串所描述，其中每個字元都是 「p」 或 「) 」。。 字串中的第一個字元一律代表根節點。 如果函式未傳回任何專案，則字串為 NULL 。

“p” 代表節點 (使用者介面自動化 元素) 。 當其中一個 「p」 直接遵循另一個時，第二個節點是第一個節點的子系。 “) ” 代表樹狀結構備份的步驟。 例如，“pp) p” 代表一個節點，後面接著兩個彼此同層級的子節點。 在 「pp) ) p」 中，最後一個節點是第一個節點的同層級。

規格需求

需求	值
最低支援的用戶端	Windows XP [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003 [僅限傳統型應用程式]
目標平台	Windows
標頭	uiautomationcoreapi.h
程式庫	Uiautomationcore.lib
Dll	Uiautomationcore.dll