GetTextFace
The GetTextFace
function retrieves the typeface name of the font that is selected into the
specified device context.
int GetTextFace(
|
HDC hdc, |
// handle of device
context |
|
int nCount, |
// length of buffer
receiving typeface name |
|
LPTSTR lpFaceName |
// address of
buffer receiving typeface name |
|
); |
|
Parameters
hdc
Identifies
the device context.
nCount
Specifies the
size, in characters, of the buffer.
lpFaceName
Points to the
buffer that is to receive the typeface name. If this parameter is NULL, the
function returns the number of characters in the name, including the
terminating null character.
Return Values
If the
function succeeds, the return value is the number of characters copied to the
buffer.
If the
function fails, the return value is zero. To get extended error information,
call GetLastError.
Remarks
The typeface
name is copied as a null-terminated character string.
If the name
is longer than the number of characters specified by the nCount
parameter, the name is truncated.
See Also