通过

IDWriteTextLayout：：HitTestPoint 方法 (dwrite.h)

  • 项目

应用程序调用此函数传入相对于布局框左上角位置的特定像素位置，并获取发生命中测试的文本字符串的对应命中测试指标的信息。 当指定的像素位置在文本字符串之外时，函数会将输出值 *isInside 设置为 FALSE。

语法

HRESULT HitTestPoint(
        FLOAT                   pointX,
        FLOAT                   pointY,
  [out] BOOL                    *isTrailingHit,
  [out] BOOL                    *isInside,
  [out] DWRITE_HIT_TEST_METRICS *hitTestMetrics
);

参数

pointX

类型： FLOAT

要命中测试的像素位置 X，相对于布局框的左上角位置。

pointY

类型： FLOAT

要命中测试的像素位置 Y，相对于布局框的左上角位置。

[out] isTrailingHit

类型： BOOL*

一个输出标志，指示命中测试位置是位于字符的前导端还是尾部。 当输出 *isInside 值设置为 FALSE 时，将根据输出 hitTestMetrics-textPosition> 值设置此值，以表示最接近命中测试位置的边缘。

[out] isInside

类型： BOOL*

一个输出标志，指示命中测试位置是否在文本字符串内。 如果 为 FALSE，则返回最接近文本边缘的位置。

[out] hitTestMetrics

类型： DWRITE_HIT_TEST_METRICS*

完全封闭命中测试位置的输出几何图形。 当输出 *isInside 值设置为 FALSE 时，此结构表示包含最接近命中测试位置的边缘的几何图形。

返回值

类型： 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