Export (0) Print
Expand All
Expand Minimize

FONTOBJ_pQueryGlyphAttrs function

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.

iMode [in]

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

FlagDefinition

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

Version

Available in Windows 2000 and later versions of the Windows operating systems.

Header

Winddi.h (include Winddi.h)

Library

Win32k.lib

DLL

Win32k.sys

See also

DrvQueryGlyphAttrs
FONTOBJ
FD_GLYPHATTR

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft