Structure PATHDATA (winddi.h)

La structure PATHDATA décrit tout ou partie d’un sous-chemin.

Syntaxe

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

Membres

flags

Les indicateurs décrivant les données retournées sont définis comme suit :

Valeur	Signification
PD_ALL	Cet indicateur est la combinaison ORed des autres indicateurs de ce tableau. Autrement dit, PD_ALL == PD_BEGINSUBPATH | PD_ENDSUBPATH | PD_RESETSTYLE | PD_CLOSEFIGURE | PD_BEZIERS.
PD_BEGINSUBPATH	Le premier point commence un nouveau sous-chemin. Il n’est pas connecté au sous-chemin précédent. Si cet indicateur n’est pas défini, le point de départ de la première courbe à dessiner à partir de ces données est le dernier point retourné dans l’appel précédent.
PD_BEZIERS	Si la valeur est définie, chaque jeu de trois points de contrôle retourné pour cet appel décrit une courbe de Béziers. S’il est clair, chaque point de contrôle décrit un segment de ligne. Un point de départ pour l’un ou l’autre type est explicite au début du sous-chemin ou implicite en tant que point de terminaison de la courbe précédente.
PD_CLOSEFIGURE	Ce bit est défini uniquement si l’enregistrement termine un sous-chemin. S’il est défini, il existe un segment de ligne implicite qui connecte le dernier point du sous-chemin au premier point. Si un tel sous-chemin fermé est tracé, des jointures sont utilisées tout autour du chemin, et il n’y a pas de limite de fin. Si cet indicateur n’est pas défini, le sous-chemin est considéré comme ouvert, même si le premier et le dernier point coïncident. Dans ce cas, les extrémités doivent être dessinées. Cet indicateur n’est pas pertinent pour le remplissage, car tous les sous-chemins sont supposés fermés lorsqu’un chemin d’accès est rempli.
PD_ENDSUBPATH	Le dernier point du tableau termine le sous-chemin. Ce sous-chemin peut être ouvert ou fermé en fonction de l’indicateur PD_CLOSEFIGURE. Si d’autres données doivent être retournées dans le chemin d’accès, l’enregistrement suivant commence un nouveau sous-chemin. Notez qu’un enregistrement unique peut commencer et se terminer par un sous-chemin.
PD_RESETSTYLE	Ce bit est défini uniquement si cet enregistrement commence un nouveau sous-chemin. S’il est défini, il indique que l’état de style doit être réinitialisé à zéro au début du sous-chemin. S’il n’est pas défini, l’état de style est défini par la structure LINEATTRS ou continue à partir du sous-chemin précédent.

count

Spécifie le nombre de structures POINTFIX pointées vers pptfx.

pptfx

Pointeur vers un tableau de structures POINTFIX qui définissent les points de contrôle des courbes. Ces structures ne doivent pas être modifiées. Pour obtenir une description de la structure POINTFIX, consultez Types de données GDI.

Remarques

La structure PATHDATA décrit tout ou partie d’un sous-chemin. Par exemple, un appel MoveTo par une application dans un chemin d’accès commence un nouveau sous-chemin.

Configuration requise

Condition requise	Valeur
En-tête	winddi.h (inclure Winddi.h)

Voir aussi

LINEATTRS

PATHOBJ_bEnum