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。 此參數的其他位旗標如下所示。
可以合併位旗標。
| 值 | 意義 |
|---|---|
|
如果點的螢幕座標包含在字元周框方塊中，傳回的範圍位置就是最接近點螢幕座標的周框邊緣。 |
|
如果點的螢幕座標未包含在字元周框方塊中，則會傳回最接近的範圍位置。 |
[out] ppRange
接收 ITfRange 介面的指標。
傳回值
這個方法可以傳回下列其中一個值。
| 值 | 描述 |
|---|---|
|
此方法成功。 |
|
pptScreen 參數未涵蓋任何文件文字。 |
|
應用程式尚未計算文字版面配置。 |
|
指定的編輯 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_ROUND_NEAREST