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

请参阅

IDWriteFontFace