Share via

GetTextFace

  • Article

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] Integer that specifies the size, in characters, of the buffer.
  • lpFaceName
    [out] Long pointer to the buffer that receives 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

GetTextFace copies the typeface name as a null-terminated character string.

If the name is longer than the number of characters that the nCount parameter specifies, GetTextFace truncates the name.

Requirements

OS Versions: Windows CE 1.0 and later.
Header: Windows.h.
Link Library: Coredll.lib.

See Also

GetTextColor | GetTextMetrics

Last updated on Wednesday, April 13, 2005

© 2005 Microsoft Corporation. All rights reserved.