Export (0) Print
Expand All

GetTextCharsetInfo function

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

Syntax


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

Parameters

hdc [in]

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

lpSig [out, optional]

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 [in]

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:

ANSI_CHARSET
BALTIC_CHARSET
CHINESEBIG5_CHARSET
DEFAULT_CHARSET
EASTEUROPE_CHARSET
GB2312_CHARSET
GREEK_CHARSET
HANGUL_CHARSET
MAC_CHARSET
OEM_CHARSET
RUSSIAN_CHARSET
SHIFTJIS_CHARSET
SYMBOL_CHARSET
TURKISH_CHARSET
VIETNAMESE_CHARSET
JOHAB_CHARSET
ARABIC_CHARSET
HEBREW_CHARSET
THAI_CHARSET

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]

Header

Wingdi.h (include Windows.h)

Library

Gdi32.lib

DLL

Gdi32.dll

See also

Unicode and Character Sets
Unicode and Character Set Functions
GetTextCharset
TranslateCharsetInfo
FONTSIGNATURE

 

 

Community Additions

ADD
Show:
© 2014 Microsoft