GetTextFace

Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.

This function retrieves the typeface name of the font that is selected into the specified device context (DC).

int
GetTextFace( HDC
hdc
, int
nCount
, LPTSTR
lpFaceName
);

Parameters

hdc

[in] Handle to the device context (DC).

nCount

[in] Specifies the size, in characters, of the buffer.

lpFaceName

[out] Long pointer 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

The number of characters copied to the buffer indicates success. Zero indicates failure. 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 nCountparameter, the name is truncated.

Requirements

Runs on	Versions	Defined in	Include	Link to
Windows CE OS	1.0 and later	Wingdi.h		Mgrast2.lib, Mgtt.lib

Note This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.