getGlyphIndicesW 函数 (wingdi.h)

GetGlyphIndices 函数将字符串转换为字形索引数组。函数可用于确定字体中是否存在字形。

语法

DWORD GetGlyphIndicesW(
  [in]  HDC     hdc,
  [in]  LPCWSTR lpstr,
  [in]  int     c,
  [out] LPWORD  pgi,
  [in]  DWORD   fl
);

[in] hdc

设备上下文的句柄。

[in] lpstr

指向要转换的字符串的指针。

[in] c

lpstr 指向的字符串长度和以 WORD 为单位的大小 (长度，) pgi 指向的缓冲区。

[out] pgi

此缓冲区必须为 c 维。成功返回时，包含与字符串中的字符对应的字形索引数组。

[in] fl

指定如果标志符号不受支持，应如何处理这些字形。此参数可以是以下值。

值	含义
GGI_MARK_NONEXISTING_GLYPHS	使用十六进制值0xffff标记不受支持的字形。

如果函数成功，它将返回) 转换的 Unicode 函数) 或 WORD (的 ANSI 函数 (字节数。

如果函数失败，则返回值GDI_ERROR。

此函数尝试为 lpstr 指向的字符串中的每个字符标识单字形表示形式。虽然这对于某些低级别用途 (（如) 操作字体文件）很有用，但希望将字符串映射到字形的较高级别应用程序通常希望使用 Uniscribe 函数。

注意

wingdi.h 标头将 GetGlyphIndices 定义为别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。将非特定编码别名与非非特定编码的代码混合使用可能会导致不匹配，从而导致编译或运行时错误。有关详细信息，请参阅函数原型的约定。

要求	值
最低受支持的客户端	Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
目标平台	Windows
标头	wingdi.h (包括 Windows.h)
Library	Gdi32.lib
DLL	Gdi32.dll