描述
GetTextFace函数检索在指定的设备上下文中选择的字体的字体名称。
C++ 语法
int GetTextFace( __in HDC hdc, __in int nCount, __out LPTSTR lpFaceName ); |
PowerBASIC 语法
FUNCTION GetTextFaceA ( _ BYVAL hdc AS DWORD, _ BYVAL nCount AS LONG, _ BYREF lpFaceName AS ASCIIZ _ ) AS LONG |
Unicode版本:
FUNCTION GetTextFaceW ( _ BYVAL hdc AS DWORD, _ BYVAL nCount AS LONG, _ BYREF lpFaceName AS WSTRINGZ _ ) AS LONG |
参数
hdc
[in]处理设备上下文。
nCount
[in]指定lpFaceName指向的缓冲区的长度。对于ANSI函数，它是一个BYTE计数，对于Unicode函数，它是一个WORD计数。请注意，对于ANSI函数，SBCS代码页中的字符各占一个字节，而DBCS代码页中的大部分字符都需要两个字节;对于Unicode功能，大多数当前定义的Unicode字符（基本多语言平面（BMP）中的Unicode字符）是一个WORD，而Unicode代理是两个WORDs.
lpFaceName
[out]指向接收字体名称的缓冲区的指针。如果此参数为NULL，则该函数返回名称中包含终止空字符的字符数。
返回值
如果函数成功，则返回值是复制到缓冲区的字符数。
如果函数失败，返回值为零。
备注
字体名称被复制为以空字符结尾的字符串。
如果名称长于nCount参数指定的字符数，则名称将被截断。
Windows 95/98 / Me：Microsoft Layer for Unicode支持GetTextFaceW.
引用文件 #INCLUDE Once
WinGdi.inc（包括Windows.inc）