ITextStoreACP2::GetACPFromPoint 方法 (textstor.h)

将屏幕坐标中的点转换为应用程序字符位置。

语法

HRESULT GetACPFromPoint(
  [in]  TsViewCookie vcView,
  [in]  const POINT  *ptScreen,
  [in]  DWORD        dwFlags,
  [out] LONG         *pacp
);

参数

[in] vcView

指定上下文视图。

[in] ptScreen

指向 POINT 结构的指针,其中包含点的屏幕坐标。

[in] dwFlags

指定要基于相对于字符边界框的点的屏幕坐标返回的字符位置。 默认情况下,返回的字符位置是包含点的屏幕坐标的字符边界框。 如果该点位于字符边界框之外,则 该方法返回 NULLTF_E_INVALIDPOINT。 此参数的其他位标志如下所示。

位标志可以组合使用。

含义
GXFPF_ROUND_NEAREST
如果点的屏幕坐标包含在字符边界框中,则返回的字符位置是最接近点的屏幕坐标的边界边缘。
GXFPF_NEAREST
如果点的屏幕坐标未包含在字符边界框中,则返回最近的字符位置。

[out] pacp

接收与点的屏幕坐标相对应的字符位置。

返回值

此方法可以返回其中一个值。

说明
S_OK
方法成功。
TS_E_INVALIDPOINT
ptScreen 参数不在任何字符的边界框中。
TS_E_NOLAYOUT
应用程序尚未计算文本布局。

要求

要求
最低受支持的客户端 Windows 8 [桌面应用 |UWP 应用]
最低受支持的服务器 Windows Server 2012 [桌面应用 |UWP 应用]
目标平台 Windows
标头 textstor.h
DLL Msctf.dll

另请参阅

GXFPF_* 常量

ITextStoreACP2

ITfContextOwner::GetACPFromPoint

ITfContextView::GetRangeFromPoint

管理器返回值

TsViewCookie