STROBJ_bGetAdvanceWidths-Funktion (winddi.h)
Die STROBJ_bGetAdvanceWidths-Funktion ruft ein Array von Vektoren ab, das die wahrscheinlichen Breiten von Glyphen aus einer angegebenen Zeichenfolge angibt.
Syntax
ENGAPI BOOL STROBJ_bGetAdvanceWidths(
STROBJ *pso,
[in] ULONG iFirst,
ULONG c,
POINTQF *pptqD
);
Parameter
pso
Ein vom Aufrufer bereitgestellter Zeiger auf eine STROBJ-Struktur , die eine Textzeichenfolge beschreibt. Dies ist in der Regel die STROBJ-Struktur, die von der DrvTextOut-Funktion des Treibers empfangen wird.
[in] iFirst
Ist ein vom Aufrufer bereitgestellter, nullbasierter Index in der textzeichenfolge, die von der STROBJ-Struktur bereitgestellt wird. Dieser Index stellt das erste Zeichen der Zeichenfolge dar, für das eine Breite zurückgegeben werden soll.
c
Ist eine vom Aufrufer angegebene Anzahl der anzahl zusammenhängender Zeichen , beginnend und des von iFirst angegebenen Zeichens, für die Breitenwerte zurückgegeben werden sollen.
pptqD
Ein vom Aufrufer bereitgestellter Zeiger auf ein Array von POINTQF-Strukturen in c-Größe, um Zeichenbreiten im Format (28.36, 28.36) zu empfangen. Eine Beschreibung dieses Datentyps finden Sie unter GDI-Datentypen.
Rückgabewert
Wenn der Vorgang erfolgreich ist, gibt die Funktion TRUE zurück. Andernfalls wird FALSE zurückgegeben.
Hinweise
Die STROBJ_bGetAdvanceWidths-Funktion ist nützlich für Druckertreiber, die STROBJ_bEnumPositionsOnly anstelle von STROBJ_bEnum aufrufen. Die Funktion füllt das pptqD-Array mit den wahrscheinlichen Breiten der Glyphen einer Zeichenfolge auf und kann verwendet werden, um die Druckerposition nach einer vom Drucker gerenderten Zeichenfolge zu berechnen, wenn die Renderinghardware des Druckers keine exakten Zeichenbreiten zurückgibt.
Beachten Sie, dass von STROBJ_bEnumPositionsOnly zurückgegebene Glyphenpositionen nicht unbedingt genau den von STROBJ_bGetAdvanceWidths zurückgegebenen Breiten entsprechen .
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 |