GetTextCharsetInfo function

Retrieves information about the character set of the font that is currently selected into a specified device context.

Syntax

int GetTextCharsetInfo(
  HDC             hdc,
  LPFONTSIGNATURE lpSig,
  DWORD           dwFlags
);

Parameters

hdc

Handle to a device context. The function obtains information about the font that is selected into this device context.

lpSig

Pointer to a FONTSIGNATURE data structure that receives font-signature information.

If a TrueType font is currently selected into the device context, the FONTSIGNATURE structure receives information that identifies the code page and Unicode subranges for which the font provides glyphs.

If a font other than TrueType is currently selected into the device context, the FONTSIGNATURE structure receives zeros. In this case, the application should use the TranslateCharsetInfo function to obtain generic font-signature information for the character set.

The lpSig parameter specifies NULL if the application does not require the FONTSIGNATURE information. In this case, the application can also call the GetTextCharset function, which is equivalent to calling GetTextCharsetInfo with lpSig set to NULL.

dwFlags

Reserved; must be set to 0.

Return Value

If successful, returns a value identifying the character set of the font currently selected into the specified device context. The following character set identifiers are defined:

If the function fails, the return value is DEFAULT_CHARSET.

Requirements

   
Minimum supported client Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header wingdi.h (include Windows.h)
Library Gdi32.lib
DLL Gdi32.dll

See Also

FONTSIGNATURE

GetTextCharset

TranslateCharsetInfo

Unicode and Character Set Functions

Unicode and Character Sets