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

Weitere Informationen

DrvTextOut

STROBJ

STROBJ_bEnum

STROBJ_bEnumPositionsOnly