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 |