GetTextCharsetInfo
The GetTextCharsetInfo
function obtains information about the character set of the font that is
currently selected into a specified device context.
UINT GetTextCharsetInfo(
|
HDC hdc, |
// handle
to device context |
|
LPFONTSIGNATURE lpSig, |
// pointer
to structure to receive Unicode and code page data |
|
DWORD dwFlags |
//
reserved; must be zero |
|
); |
|
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 codepage 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 zeroes. In this case, use the TranslateCharsetInfo function to obtain generic
font-signature information for the character set.
The lpSig
parameter can be NULL if you do not need the FONTSIGNATURE information.
In this case, you can also call the GetTextCharset function, which is
equivalent to calling GetTextCharsetInfo with lpSig set to
NULL.
dwFlags
This
parameter is reserved for future use. It must be set to zero.
Return Values
If the
function succeeds, the return value identifies the character set of the font
currently selected into the specified device context. The following
character-set identifiers are defined:
ANSI_CHARSET
CHINESEBIG5_CHARSET
DEFAULT_CHARSET
GB2312_CHARSET
HANGEUL_CHARSET
OEM_CHARSET
SHIFTJIS_CHARSET
SYMBOL_CHARSET
Windows
95 only:
ARABIC_CHARSET
BALTIC_CHARSET
EASTEUROPE_CHARSET
GREEK_CHARSET
HEBREW_CHARSET
JOHAB_CHARSET
MAC_CHARSET
RUSSIAN_CHARSET
THAI_CHARSET
TURKISH_CHARSET
If the
function fails, the return value is DEFAULT_CHARSET.
See Also