Export (0) Print
Expand All

GetFontLanguageInfo function

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.

Syntax


DWORD GetFontLanguageInfo(
  _In_  HDC hdc
);

Parameters

hdc [in]

Handle to a display device context.

Return value

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.

ValueMeaning
GCP_DBCSThe character set is DBCS.
GCP_DIACRITICThe font/language contains diacritic glyphs.
FLI_GLYPHSThe font contains extra glyphs not normally accessible using the code page. Use GetCharacterPlacement to access the glyphs. This value is for information only and is not intended to be passed to GetCharacterPlacement.
GCP_GLYPHSHAPEThe 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 specified, 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_KASHIDAThe font/ language permits Kashidas.
GCP_LIGATEThe font/language contains ligation glyphs which can be substituted for specific character combinations.
GCP_USEKERNINGThe font contains a kerning table which can be used to provide better spacing between the characters and glyphs.
GCP_REORDERThe language requires reordering for displayfor example, Hebrew or Arabic.

 

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

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

Fonts and Text Overview
Font and Text Functions
ExtTextOut
GetCharacterPlacement

 

 

Community Additions

ADD
Show:
© 2014 Microsoft