IDWriteTextAnalysisSource：：GetTextAtPosition 方法 (dwrite.h)

获取从指定文本位置开始的文本块。

语法

HRESULT GetTextAtPosition(
        UINT32      textPosition,
  [out] WCHAR const **textString,
  [out] UINT32      *textLength
);

textPosition

类型： UINT32

要获取的片段的第一个位置。所有位置都在 UTF16 代码单元中，而不是整个字符，这在使用补充字符时很重要。

[out] textString

类型： const WCHAR**

此方法返回时，包含文本块的地址，作为要从文本分析中检索的字符数组。

[out] textLength

类型： UINT32*

此方法返回时，包含检索到的区块的 UTF16 单位数。返回的长度不是块的长度，而是块中从指定位置到其结束的剩余长度。例如，在 100 个位置块中查询 75 个位置的位置将返回 25。

类型： HRESULT

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

返回 NULL 表示文本的末尾，即最后一个字符之后的位置。对于每个连续块，以迭代方式调用此函数，将后备存储中的多个碎片块捆绑在一个虚拟连续字符串中。

尽管应用程序可以实现仅映射部分后备存储的稀疏文本内容，但应用程序必须映射传递到任何分析函数的范围内的任何文本。


最低受支持的客户端	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