FONTOBJ_pQueryGlyphAttrs function (winddi.h)

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

Syntax

PFD_GLYPHATTR FONTOBJ_pQueryGlyphAttrs(
  FONTOBJ *pfo,
  ULONG   iMode
);

Parameters

pfo

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

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

   
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

See also

DrvQueryGlyphAttrs

FD_GLYPHATTR

FONTOBJ