EngStrokeAndFillPath-Funktion (winddi.h)

Artikel
08/27/2023

Die EngStrokeAndFillPath-Funktion bewirkt, dass GDI einen Pfad ausfüllt und gleichzeitig strichelt.

Syntax

ENGAPI BOOL EngStrokeAndFillPath(
       SURFOBJ   *pso,
       PATHOBJ   *ppo,
       CLIPOBJ   *pco,
       XFORMOBJ  *pxo,
       BRUSHOBJ  *pboStroke,
       LINEATTRS *plineattrs,
       BRUSHOBJ  *pboFill,
       POINTL    *pptlBrushOrg,
  [in] MIX       mixFill,
  [in] FLONG     flOptions
);

Parameter

pso

Zeiger auf eine SURFOBJ-Struktur , die die Zeichnungsoberfläche definiert.

ppo

Zeiger auf eine PATHOBJ-Struktur , die den auszufüllenden Pfad definiert. Die PATHOBJ_Xxx-Dienstroutinen werden bereitgestellt, um die Linien, Bézierkurven und andere Daten aufzulisten, aus denen der Pfad besteht.

pco

Zeiger auf eine CLIPOBJ-Struktur . Die CLIPOBJ_Xxx-Dienstroutinen werden bereitgestellt, um den Clipbereich als Eine Reihe von Rechtecken aufzulisten.

pxo

Zeiger auf eine XFORMOBJ-Struktur , die nur benötigt wird, wenn eine geometrische breite Linie gezeichnet werden soll, und gibt die Transformation an, die Weltkoordinaten in Gerätekoordinaten konvertiert. Der Pfad wird in Gerätekoordinaten angegeben, aber eine geometrische breite Linie wird tatsächlich in Weltkoordinaten erweitert.

Der Treiber kann die XFORMOBJ_Xxx-Dienstroutinen verwenden, um die Transformation zu bestimmen.

pboStroke

Zeiger auf eine BRUSHOBJ-Struktur , die den Pinsel beschreibt, der beim Streichen des Pfads verwendet werden soll.

plineattrs

Zeiger auf eine LINEATTRS-Struktur .

pboFill

Zeiger auf eine BRUSHOBJ-Struktur, die den Pinsel beschreibt, der beim Füllen des Pfads verwendet werden soll.

pptlBrushOrg

Zeiger auf eine POINTL-Struktur , die den Pinselursprung für beide Pinsel definiert.

[in] mixFill

Definiert die Vordergrund- und Hintergrundrastervorgänge, die für den Füllpinsel verwendet werden sollen.

[in] flOptions

Gibt an, welcher Füllmodus verwendet werden soll. Dieser Parameter kann FP_WINDINGMODE oder FP_ALTERNATEMODE sein. alle anderen Bits sollten ignoriert werden. Weitere Informationen zu diesen Modi finden Sie unter Pfadfüllmodi.

Rückgabewert

Der Rückgabewert ist TRUE , wenn GDI den Pfad ausfüllt. Wenn der Treiber den Pfad ausfüllen soll, ist der Rückgabewert FALSE, und ein Fehlercode wird nicht protokolliert. Wenn bei GDI ein unerwarteter Fehler auftritt, z. B. der Pinsel nicht realisiert werden kann, wird der Rückgabewert DDI_ERROR, und ein Fehlercode wird protokolliert.

Hinweise

Der Mischmodus definiert, wie das eingehende Muster mit den Daten gemischt werden soll, die sich bereits auf der Geräteoberfläche befinden. Der MIX-Datentyp besteht aus zwei ROP2-Werten, die in eine einzelne ULONG gepackt sind. Das Byte mit niedriger Ordnung definiert den Rastervorgang im Vordergrund. das nächste Byte definiert den Hintergrundrastervorgang. Weitere Informationen zu Rastervorgangscodes finden Sie in der Dokumentation zu Microsoft Windows SDK.

Anforderungen


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