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

Weitere Informationen

CLIPLINE

PATHOBJ

PATHOBJ_vEnumStartClipLines

AUSFÜHREN