idWriteFontFace::GetGlyphIndices 方法 (dwrite.h)
返回由字体“CMAP”表定义的 UCS4 Unicode 码位到字形索引的标称映射。
语法
HRESULT GetGlyphIndices(
[in] UINT32 const *codePoints,
UINT32 codePointCount,
[out] UINT16 *glyphIndices
);
参数
[in] codePoints
类型: const UINT32*
要从中获取名义字形索引的 USC4 码位数组。 必须分配数组,并且能够包含 codePointCount 指定的元素数。
codePointCount
类型: UINT32
codePoints 数组中的元素数。
[out] glyphIndices
类型: UINT16*
此方法返回时,包含指向此函数填充的标称字形索引数组的指针。
返回值
类型: HRESULT
如果该方法成功,则返回 S_OK。 否则,将返回 HRESULT 错误代码。
备注
请注意,此映射主要用于基于物理字体 API 构建的行布局引擎。 由于 OpenType 字形替换和行布局字符替换,标称转换并不总是对应于使用特定字体呈现时 Unicode 字符串映射到字形索引的方式。 另请注意,Unicode 变体选择器提供字符到字形的备用映射。 此调用将始终返回默认变体。
当字体中不存在字符时,此方法返回索引 0,即未定义的字形或“.notdef”字形。 如果字符不在字体中,IDWriteFont::HasCharacter 将返回 false,而 GetUnicodeRanges 不会在范围中返回该字符。
要求
最低受支持的客户端 | 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 |