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 位於字元周框方塊中,而點 2 位於字元周框方塊外。](images/rngfig01.gif)
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 2000 專業版 [傳統型應用程式 |UWP 應用程式] |
最低支援的伺服器 | Windows 2000 Server [傳統型應用程式 |UWP 應用程式] |
目標平台 | Windows |
標頭 | msctf.h |
Dll | Msctf.dll |
可轉散發套件 | Windows 2000 專業版上的 TSF 1.0 |
另請參閱
GXFPF_ROUND_NEAREST