GetFontLanguageInfo

The GetFontLanguageInfo function returns information about the currently selected font for the specified display context. Applications typically use this information and the GetCharacterPlacement function to prepare a character string for display.

DWORD GetFontLanguageInfo(
  HDC hdc  // handle to a device context
);
 

Parameters

hdc
Handle to a display context.

Return Values

The return value identifies characteristics of the currently selected font. The function returns 0 if the font is "normalized" and can be treated as a simple Latin font; it returns GCP_ERROR if an error occurs. Otherwise, the function returns a combination of the following values:

Value Meaning
GCP_DBCS The character set is DBCS.
GCP_DIACRITIC The font/language contains diacritic glyphs
FLI_GLYPHS The font contains extra glyphs not normally accessible using the codepage. Use GetCharacterPlacement to access the glyphs. This value is for information only and is not intended to be passed to GetCharacterPlacement.
GCP_GLYPHSHAPE The font/language contains multiple glyphs per code point or per code point combination (supports shaping and/or ligation), and the font contains advanced glyph tables to provide extra glyphs for the extra shapes. If this value is given, the lpGlyphs array must be used with the GetCharacterPlacement function and the ETO_GLYPHINDEX value must be passed to the ExtTextOut function when the string is drawn.
GCP_KASHIDA The font/ language permits Kashidas.
GCP_LIGATE The font/language contains ligation glyphs which can be substituted for specific character combinations.
GCP_USEKERNING The font contains a kerning table which can be used to provide better spacing between the characters and glyphs.
GCP_REORDER The language requires reordering for display--for example, Hebrew or Arabic.

The return value, when masked with FLI_MASK, can be passed directly to the GetCharacterPlacement function.

Windows NT: To get extended error information, call GetLastError.

QuickInfo

  Windows NT: Requires version 4.0 or later.
  Windows: Requires Windows 95 or later.
  Windows CE: Unsupported.
  Header: Declared in wingdi.h.
  Import Library: Use gdi32.lib.

See Also

Fonts and Text Overview, Font and Text Functions, ExtTextOut, GetCharacterPlacement