Freigeben über


PATHDATA-Struktur (winddi.h)

Die PATHDATA-Struktur beschreibt einen Teilpfad ganz oder teilweise.

Syntax

typedef struct _PATHDATA {
  FLONG    flags;
  ULONG    count;
  POINTFIX *pptfx;
} PATHDATA, *PPATHDATA;

Member

flags

Flags, die die zurückgegebenen Daten beschreiben, werden wie folgt definiert:

Wert Bedeutung
PD_ALL Dieses Flag ist die ORed-Kombination der anderen Flags in dieser Tabelle. Das heißt, PD_ALL == PD_BEGINSUBPATH | PD_ENDSUBPATH | PD_RESETSTYLE | PD_CLOSEFIGURE | PD_BEZIERS.
PD_BEGINSUBPATH Der erste Punkt beginnt mit einem neuen Unterpfad. Er ist nicht mit dem vorherigen Unterpfad verbunden. Wenn dieses Flag nicht festgelegt ist, ist der Ausgangspunkt für die erste Kurve, die aus diesen Daten gezogen werden soll, der letzte Punkt, der im vorherigen Aufruf zurückgegeben wurde.
PD_BEZIERS Wenn festgelegt, beschreibt jeder Satz von drei Kontrollpunkten, die für diesen Aufruf zurückgegeben werden, eine Bézierkurve. Wenn sie eindeutig sind, beschreibt jeder Steuerungspunkt ein Liniensegment. Ein Startpunkt für beide Typen ist entweder explizit am Anfang des Unterpfads oder implizit als Endpunkt der vorherigen Kurve.
PD_CLOSEFIGURE Dieses Bit wird nur definiert, wenn der Datensatz einen Unterpfad beendet. Wenn festgelegt, besteht ein implizites Zeilensegment, das den letzten Punkt des Unterpfads mit dem ersten Punkt verbindet. Wenn ein solcher geschlossener Unterpfad striche wird, werden Verknüpfungen rund um den Pfad verwendet, und es gibt keine Endkappen. Wenn dieses Flag nicht festgelegt ist, gilt der Unterpfad als geöffnet, auch wenn der erste und der letzte Punkt zufällig zusammenfallen. In diesem Fall sollten Endkappen gezeichnet werden. Dieses Flag ist für das Ausfüllen nicht relevant, da alle Unterpfade beim Füllen eines Pfads von geschlossen angenommen werden.
PD_ENDSUBPATH Der letzte Punkt im Array endet den Unterpfad. Dieser Unterpfad kann je nach PD_CLOSEFIGURE Flag geöffnet oder geschlossen werden. Wenn im Pfad weitere Daten zurückgegeben werden müssen, beginnt der nächste Datensatz mit einem neuen Unterpfad. Beachten Sie, dass ein einzelner Datensatz einen Unterpfad beginnen und beenden kann.
PD_RESETSTYLE Dieses Bit wird nur definiert, wenn dieser Datensatz einen neuen Unterpfad beginnt. Wenn festgelegt, gibt dies an, dass der Formatzustand am Anfang des Unterpfads auf 0 zurückgesetzt werden soll. Wenn nicht festgelegt, wird der Formatzustand von der LINEATTRS-Struktur definiert oder vom vorherigen Unterpfad fortgesetzt.

count

Gibt die Anzahl der POINTFIX-Strukturen an, auf die von pptfx verwiesen wird.

pptfx

Zeiger auf ein Array von POINTFIX-Strukturen, die die Kontrollpunkte für die Kurven definieren. Diese Strukturen dürfen nicht geändert werden. Eine Beschreibung der POINTFIX-Struktur finden Sie unter GDI-Datentypen.

Hinweise

Die PATHDATA-Struktur beschreibt einen Teilpfad ganz oder teilweise. Ein MoveTo-Aufruf einer Anwendung innerhalb eines Pfads beginnt beispielsweise mit einem neuen Unterpfad.

Anforderungen

Anforderung Wert
Header winddi.h (einschließlich Winddi.h)

Weitere Informationen

LINEATTRS

PATHOBJ_bEnum