GetPath, fonction (wingdi.h)

Article
03/08/2023

La fonction GetPath récupère les coordonnées définissant les points de terminaison des lignes et les points de contrôle des courbes trouvés dans le chemin sélectionné dans le contexte d’appareil spécifié.

Syntaxe

int GetPath(
  [in]  HDC     hdc,
  [out] LPPOINT apt,
  [out] LPBYTE  aj,
  [in]  int     cpt
);

Paramètres

[in] hdc

Handle vers un contexte d’appareil qui contient un chemin fermé.

[out] apt

Pointeur vers un tableau de structures POINT qui reçoit les points de terminaison de ligne et les points de contrôle de courbe, en coordonnées logiques.

[out] aj

Pointeur vers un tableau d’octets qui reçoit les types de vertex. Ce paramètre peut prendre les valeurs suivantes.

Type	Description
PT_MOVETO	Spécifie que le point correspondant dans le paramètre lpPoints démarre une figure disjointe.
PT_LINETO	Spécifie que le point précédent et le point correspondant dans lpPoints sont les points de terminaison d’une ligne.
PT_BEZIERTO	Spécifie que le point correspondant dans lpPoints est un point de contrôle ou un point de terminaison pour une courbe de Bézier. PT_BEZIERTO valeurs se produisent toujours dans des ensembles de trois. Le point du chemin qui les précède immédiatement définit le point de départ de la courbe de Bézier. Les deux premiers points PT_BEZIERTO sont les points de contrôle, et le troisième point PT_BEZIERTO est le point de fin (s’il est codé en dur).

Une valeur PT_LINETO ou PT_BEZIERTO peut être combinée avec la valeur suivante (à l’aide de l’opérateur au niveau du bit OR) pour indiquer que le point correspondant est le dernier point d’une figure et que la figure doit être fermée.

Indicateur	Description
PT_CLOSEFIGURE	Spécifie que la figure est automatiquement fermée une fois la ligne ou la courbe correspondante dessinée. La figure est fermée en dessinant une ligne à partir du point de terminaison de ligne ou de courbe jusqu’au point correspondant au dernier PT_MOVETO.

[in] cpt

Nombre total de structures POINT pouvant être stockées dans le tableau pointé par lpPoints. Cette valeur doit être identique au nombre d’octets pouvant être placés dans le tableau pointé par lpTypes.

Valeur retournée

Si le paramètre nSize est différent de zéro, la valeur de retour est le nombre de points énumérés. Si nSize est 0, la valeur de retour est le nombre total de points dans le chemin d’accès (et GetPath n’écrit rien dans les mémoires tampons). Si nSize est différent de zéro et est inférieur au nombre de points dans le chemin, la valeur de retour est 1.

Remarques

Le contexte de l’appareil identifié par le paramètre hdc doit contenir un chemin fermé.

Les points du chemin sont retournés en coordonnées logiques. Les points étant stockés dans le chemin d’accès dans les coordonnées de l’appareil, GetPath remplace les points des coordonnées de l’appareil par des coordonnées logiques à l’aide de l’inverse de la transformation actuelle.

La fonction FlattenPath peut être appelée avant GetPath pour convertir toutes les courbes du chemin en segments de ligne.

Configuration requise


Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	wingdi.h (inclure Windows.h)
Bibliothèque	Gdi32.lib
DLL	Gdi32.dll