PATHOBJ_bEnumClipLines-Funktion (winddi.h)
Die PATHOBJ_bEnumClipLines-Funktion listet beschnittene Liniensegmente aus einem bestimmten Pfad auf.
Syntax
ENGAPI BOOL PATHOBJ_bEnumClipLines(
PATHOBJ *ppo,
ULONG cb,
CLIPLINE *pcl
);
Parameter
ppo
Zeiger auf die PATHOBJ-Struktur , die die beschnittenen Liniensegmente enthält, die aufgezählt werden sollen.
cb
Gibt die Größe des Ausgabepuffers in Byte an. GDI schreibt nicht über diesen Punkt im Puffer hinaus. Der Wert dieses Parameters muss groß genug sein, um eine CLIPLINE-Struktur mit mindestens einer RUN-Struktur zu enthalten. Der Treiber sollte Speicherplatz für mehrere RUN-Strukturen zuweisen.
pcl
Zeiger auf den Puffer, der eine CLIPLINE-Struktur empfängt. Die -Struktur enthält die ursprünglichen nicht beschnittenen Kontrollpunkte für ein Liniensegment. (Die richtigen Pixel für die Linie können nicht ohne die ursprünglichen Punkte berechnet werden.) RUN-Strukturen, die Sätze von Pixeln entlang der Linie beschreiben, die nicht abgeschnitten sind, werden in diesen Puffer geschrieben.
Wenn ein Clipbereich komplex ist, kann ein einzelnes Zeilensegment in viele RUN-Strukturen unterteilt werden. Ein Segment wird so oft wie nötig zurückgegeben, um alle seine RUN-Strukturen auflisten zu können.
Die CLIPLINE-Struktur enthält die Anfangs- und Endpunkte der ursprünglichen nicht markierten Linie und die Liniensegmente bzw. RUN-Strukturen dieser Zeile, die auf der Anzeige angezeigt werden sollen.
Rückgabewert
Der Rückgabewert ist TRUE , wenn weitere Zeilensegmente aufgezählt werden sollen, was angibt, dass dieser Dienst erneut aufgerufen werden soll. Andernfalls ist es FALSE, was angibt, dass das zurückgegebene Segment das letzte Segment im Pfad ist.
Hinweise
Die Enumeration muss mit PATHOBJ_vEnumStartClipLines gestartet werden, bevor der Treiber diesen Aufruf tätigt.
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 |