TextPattern_RangeFromPoint函式 (uiautomationcoreapi.h)

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

擷取最接近指定螢幕座標的空白 (空白) 文字範圍。

語法

HRESULT TextPattern_RangeFromPoint(
  [in]  HUIAPATTERNOBJECT hobj,
  [in]  UiaPoint          point,
  [out] HUIATEXTRANGE     *pRetVal
);

[in] hobj

類型： HUIAPATTERNOBJECT

控制項模式物件。

[in] point

類型：

UiaPoint結構，其中包含螢幕座標中的位置。

[out] pRetVal

類型： HUIATEXTRANGE*

當此函式傳回時，包含節點所跨越的文字範圍。這個參數會以未初始化的狀態傳遞。

類型： HRESULT

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

如果螢幕座標位於影像、超連結、Microsoft Excel 試算表或其他内嵌物件的座標內，則會傳回包裝子物件的文字範圍。

因為不會忽略隱藏文字，所以這個方法會從最接近指定座標的可見文字擷取變質範圍。