FONTOBJ_pQueryGlyphAttrs function (winddi.h)

Article
02/22/2024

The FONTOBJ_pQueryGlyphAttrs function returns information about a font's glyphs.

Syntax

PFD_GLYPHATTR FONTOBJ_pQueryGlyphAttrs(
       FONTOBJ *pfo,
  [in] ULONG   iMode
);

Parameters

pfo

Is a caller-supplied pointer to a FONTOBJ structure identifying the font for which attributes are being requested.

[in] iMode

Is a caller-supplied flag indicating the type of glyph attribute being requested. The following flag is defined:

Flag	Definition
FO_ATTR_MODE_ROTATE	The function returns an array indicating which glyphs of a vertical font must be rotated.

Return value

FONTOBJ_pQueryGlyphAttrs returns a pointer to an FD_GLYPHATTR structure. If an error is encountered, such as an invalid input argument, or if the font described by the FONTOBJ structure is not a vertical font, the function returns NULL.

Remarks

Currently, the only attribute flag defined is FO_ATTR_MODE_ROTATE. This flag is meant for use by printer drivers that support printers with built-in font rasterizers. The driver can call the FONTOBJ_pQueryGlyphAttrs function, specifying the FO_ATTR_MODE_ROTATE flag, to determine which glyphs within a vertical font must be rotated.

Vertical fonts have a font name that starts with the "@" character. To determine if the current font is a vertical font, the driver can check for the FO_VERT_FACE flag in the flFontType member of the font's FONTOBJ structure.

Rotation information is returned in the FD_GLYPHATTR structure that is used as the function's return value.

The FONTOBJ_pQueryGlyphAttrs function is supplied by GDI. When a printer driver calls FONTOBJ_pQueryGlyphAttrs, GDI calls the appropriate font driver's DrvQueryGlyphAttrs function to obtain the requested information.

Requirements

Requirement	Value
Minimum supported client	Available in Windows 2000 and later versions of the Windows operating systems.
Target Platform	Universal
Header	winddi.h (include Winddi.h)
Library	Win32k.lib
DLL	Win32k.sys