iTfContextView：：GetRangeFromPoint 方法 (msctf.h)

ITfContextView：：GetRangeFromPoint 方法會將螢幕座標的點轉換成位於對應位置的空白文字範圍。

語法

HRESULT GetRangeFromPoint(
  [in]  TfEditCookie ec,
  [in]  const POINT  *ppt,
  [in]  DWORD        dwFlags,
  [out] ITfRange     **ppRange
);

參數

[in] ec

指定具有唯讀存取權的編輯 Cookie。

[in] ppt

指定螢幕座標中的點。

[in] dwFlags

指定要根據點對字元周框方塊之螢幕座標傳回的範圍位置。 根據預設，傳回的範圍位置是包含點螢幕座標的字元周框方塊。 如果點位於字元周框方塊外，此方法會傳回 NULL 或 TF_E_INVALIDPOINT。 此參數的其他位旗標如下所示。

可以合併位旗標。

值	意義
GXFPF_ROUND_NEAREST	如果點的螢幕座標包含在字元周框方塊中，傳回的範圍位置就是最接近點螢幕座標的周框邊緣。
GXFPF_NEAREST	如果點的螢幕座標未包含在字元周框方塊中，則會傳回最接近的範圍位置。

[out] ppRange

接收 ITfRange 介面的指標。

傳回值

這個方法可以傳回下列其中一個值。

值	描述
S_OK	此方法成功。
TF_E_INVALIDPOINT	pptScreen 參數未涵蓋任何文件文字。
TF_E_NOLAYOUT	應用程式尚未計算文字版面配置。
TF_E_NOLOCK	指定的編輯 Cookie 無效。

備註

根據預設，此方法會針對點 1 傳回位於 0 的範圍，並針對點 2 傳回TF_E_INVALIDPOINT。 如果 dwFlags 參數設定為 GXFPF_ROUND_NEAREST，方法會傳回點 1 的範圍位置 1。 如果 dwFlags 參數設定為 GXFPF_NEAREST 則方法會傳回點 2 的範圍位置 2。

規格需求

需求	值
最低支援的用戶端	Windows 2000 專業版 [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器	Windows 2000 Server [傳統型應用程式 |UWP 應用程式]
目標平台	Windows
標頭	msctf.h
Dll	Msctf.dll
可轉散發套件	Windows 2000 專業版上的 TSF 1.0

另請參閱

GXFPF_NEAREST

GXFPF_ROUND_NEAREST

ITfContextView

TF_E_INVALIDPOINT