Share via


ITextProvider::RangeFromPoint 方法 (uiautomationcore.h)

傳回最接近指定之螢幕座標的變質 (空) 文字範圍。

語法

HRESULT RangeFromPoint(
  [in]          UiaPoint           point,
  [out, retval] ITextRangeProvider **pRetVal
);

參數

[in] point

類型: UiaPoint

螢幕座標中的位置。

[out, retval] pRetVal

類型: ITextRangeProvider**

接收最接近指定位置的空白) 文字範圍之變質 (指標。 這個參數會以未初始化的狀態傳遞。

傳回值

類型: HRESULT

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

備註

如果螢幕座標位於影像、超連結或其他內嵌物件的座標內,則會傳回包含子物件的文字範圍。

由於 ITextProvider::RangeFromPoint 不會忽略隱藏的文字,因此會傳回從最接近指定點的可見文字產生的範圍。

屬性永遠不會傳回 NULL

規格需求

需求
最低支援的用戶端 Windows XP [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows Server 2003 [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 uiautomationcore.h (包含 UIAutomation.h)

另請參閱

概念

ITextProvider

ITextRangeProvider

參考

UI 自動化提供者概觀