Expand Minimize

STROBJ_bEnum function

The STROBJ_bEnum function enumerates glyph identities and positions.

Syntax


BOOL STROBJ_bEnum(
  STROBJ *pstro,
  ULONG *pc,
  PGLYPHPOS *ppgpos
);

Parameters

pstro

Pointer to the STROBJ structure containing the GLYPHPOS information.

pc

Pointer to the count, returned by GDI, of GLYPHPOS structures.

ppgpos

Pointer to the array in which GDI writes the GLYPHPOS structures.

Return value

The return value is TRUE if more glyphs remain to be enumerated, or FALSE if the enumeration is complete. The return value is DDI_ERROR if the glyphs cannot be enumerated, and an error code is logged.

Remarks

A driver should download only the glyph handles if it caches fonts itself.

The information returned depends on the driver's return value for DrvGetGlyphMode.

Bitmaps or outlines can also be obtained from FONTOBJ structures.

Printer drivers should call STROBJ_bEnumPositionsOnly instead of STROBJ_bEnum if printer hardware provides internal rendering of TrueType fonts.

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

FONTOBJ_cGetGlyphs
GLYPHPOS
STROBJ
FONTOBJ
STROBJ_vEnumStart
STROBJ_bEnumPositionsOnly
DrvGetGlyphMode

 

 

Send comments about this topic to Microsoft

Show:
© 2015 Microsoft