Gdi::GetTextFaceW_I

  • Article

This method retrieves the typeface name of the font that is selected into the specified device context.

static WINGDIAPI int WINAPI GetTextFaceW_I(
  HDC hdc, 
  int nCount,
  WCHAR* lpFaceName
);

Parameters

  • hdc
    [in] Handle to the device context.
  • nCount
    [in] Integer that 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

This method is an external version of the GetTextFace function.

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.

Requirements

OS Versions: Windows CE .NET 4.0 and later.
Header: Gdi.hpp.

See Also

GetTextFace | Gdi::GetTextColor_I | Gdi::GetTextMetricsW_I

Last updated on Wednesday, April 13, 2005

© 2005 Microsoft Corporation. All rights reserved.