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
GetTextAlign, GetTextColor, GetTextExtentPoint32, GetTextMetrics