STROBJ_bEnum-Funktion (winddi.h)

Artikel
03/04/2024

Die STROBJ_bEnum-Funktion listet Glyphenidentitäten und -positionen auf.

Syntax

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

Parameter

pstro

Zeiger auf die STROBJ-Struktur , die die GLYPHPOS-Informationen enthält.

pc

Zeiger auf die Anzahl von GLYPHPOS-Strukturen, die von GDI zurückgegeben wird.

ppgpos

Zeiger auf das Array, in das GDI die GLYPHPOS-Strukturen schreibt.

Rückgabewert

Der Rückgabewert ist TRUE , wenn weitere Glyphen aufgelistet werden müssen, oder FALSE , wenn die Enumeration abgeschlossen ist. Der Rückgabewert ist DDI_ERROR, wenn die Glyphen nicht aufgezählt werden können und ein Fehlercode protokolliert wird.

Hinweise

Ein Treiber sollte nur die Glyphenhandles herunterladen, wenn er Schriftarten selbst zwischenspeichert.

Die zurückgegebenen Informationen hängen vom Rückgabewert des Treibers für DrvGetGlyphMode ab.

Bitmaps oder Gliederungen können auch aus FONTOBJ-Strukturen abgerufen werden.

Druckertreiber sollten STROBJ_bEnumPositionsOnly anstelle von STROBJ_bEnum aufrufen, wenn die Druckerhardware ein internes Rendering von TrueType-Schriftarten ermöglicht.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar in Windows 2000 und höheren Versionen der Windows-Betriebssysteme.
Zielplattform	Universell
Header	winddi.h (einschließlich Winddi.h)
Bibliothek	Win32k.lib
DLL	Win32k.sys