getTextFaceA 函数 (wingdi.h)

项目
08/27/2023

GetTextFace 函数检索在指定设备上下文中选择的字体的字体名称。

语法

int GetTextFaceA(
  [in]  HDC   hdc,
  [in]  int   c,
  [out] LPSTR lpName
);

参数

[in] hdc

设备上下文的句柄。

[in] c

lpFaceName 指向的缓冲区的长度。对于 ANSI 函数，它是 BYTE 计数，对于 Unicode 函数，它是 WORD 计数。请注意，对于 ANSI 函数，SBCS 代码页中的字符各采用一个字节，而 DBCS 代码页中的大多数字符采用两个字节：对于 Unicode 函数，当前定义的大多数 Unicode 字符 (基本多语言平面 (BMP) ) 中的字符是一个 WORD，而 Unicode 代理项是两个 WORD。

[out] lpName

指向接收字样名称的缓冲区的指针。如果此参数为 NULL，则该函数将返回名称中的字符数，包括终止 null 字符。

返回值

如果函数成功，则返回值是复制到缓冲区的字符数。

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

注解

将字体名称复制为以 null 结尾的字符串。

如果名称长于 nCount 参数指定的字符数，则名称将被截断。

注意

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

要求


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