通过

IDWriteTextLayout：：HitTestTextPosition 方法 (dwrite.h)

  • 项目

应用程序调用此函数以获取相对于布局框左上角的像素位置（给定文本位置和位置的逻辑侧）。 此函数通常用作文本插入点定位的一部分，插入点绘制在对应于当前文本编辑位置的位置。 它还可用作以编程方式获取 UI 自动化中特定文本位置几何图形的一种方式。

语法

HRESULT HitTestTextPosition(
        UINT32                  textPosition,
        BOOL                    isTrailingHit,
  [out] FLOAT                   *pointX,
  [out] FLOAT                   *pointY,
  [out] DWRITE_HIT_TEST_METRICS *hitTestMetrics
);

参数

textPosition

类型： UINT32

用于获取像素位置的文本位置。

isTrailingHit

类型： BOOL

一个布尔标志，指示像素位置是指定文本位置的前导侧还是尾随位置。

[out] pointX

类型： FLOAT*

此方法返回时，包含相对于布局框的左上角位置的输出像素位置 X。

[out] pointY

类型： FLOAT*

此方法返回时，包含相对于布局框的左上角位置的输出像素位置 Y。

[out] hitTestMetrics

类型： DWRITE_HIT_TEST_METRICS*

此方法返回时，包含完全封闭指定文本位置的输出几何图形。

返回值

类型： HRESULT

如果该方法成功，则返回 S_OK。 否则，将返回 HRESULT 错误代码。

要求

要求 值
最低受支持的客户端 Windows 7、带 SP2 的 Windows Vista 和适用于 Windows Vista 的平台更新 [桌面应用 |UWP 应用]
最低受支持的服务器 Windows Server 2008 R2、Windows Server 2008 SP2 和适用于 Windows Server 2008 的平台更新 [桌面应用 |UWP 应用]
目标平台 Windows
标头 dwrite.h
Library Dwrite.lib
DLL Dwrite.dll

另请参阅

IDWriteTextLayout