共用方式為


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

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

可以合併位旗標。

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

[out] ppRange

接收 ITfRange 介面的指標。

傳回值

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

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

備註

點 1 位於字元周框方塊中,而點 2 位於字元周框方塊外。 根據預設,此方法會針對點 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