UiaNodeFromPoint 函式 (uiautomationcoreapi.h)

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

 

擷取位於指定點之專案的 使用者介面自動化 節點。

語法

HRESULT UiaNodeFromPoint(
  [in]  double          x,
  [in]  double          y,
  [in]  UiaCacheRequest *pRequest,
  [out] SAFEARRAY       **ppRequestedData,
  [out] BSTR            *ppTreeStructure
);

參數

[in] x

類型： double

點的水準座標。

[in] y

類型： double

點的垂直座標。

[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