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

另请参阅

字体和文本函数

字体和文本概述

GetFontUnicodeRanges