UiaNodeFromFocus 函式 (uiautomationcoreapi.h)

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

擷取目前具有輸入焦點之 UI 元素的使用者介面自動化節點。

語法

HRESULT UiaNodeFromFocus(
  [in]  UiaCacheRequest *pRequest,
  [out] SAFEARRAY       **ppRequestedData,
  [out] BSTR            *ppTreeStructure
);

[in] pRequest

UiaCacheRequest 結構的位址，其中包含要快取之數據的相關信息。

[out] ppRequestedData

類型： SAFEARRAY**

接收 SAFEARRAY 指標的變數位址，其中包含要求的資訊。這個參數會以未初始化的狀態傳遞。

[out] ppTreeStructure

類型： BSTR*

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

類型： HRESULT

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

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

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