Fonction PolyDraw (wingdi.h)

Article
08/15/2024

La fonction PolyDraw dessine un ensemble de segments de trait et de courbes de Bézier.

Syntaxe

BOOL PolyDraw(
  [in] HDC         hdc,
  [in] const POINT *apt,
  [in] const BYTE  *aj,
  [in] int         cpt
);

Paramètres

[in] hdc

Handle vers un contexte d’appareil.

[in] apt

Pointeur vers un tableau de structures POINT qui contient les points de terminaison de chaque segment de ligne et les points de terminaison et points de contrôle pour chaque courbe de Bézier, en unités logiques.

[in] aj

Pointeur vers un tableau qui spécifie comment chaque point dans le tableau lppt est utilisé. Ce paramètre peut être l’une des valeurs suivantes.

Type	Signification
PT_MOVETO	Spécifie que ce point démarre une figure disjointe. Ce point devient la nouvelle position actuelle.
PT_LINETO	Spécifie qu’une ligne doit être dessinée de la position actuelle à ce point, qui devient ensuite la nouvelle position actuelle.
PT_BEZIERTO	Spécifie que ce point est un point de contrôle ou un point de terminaison pour une courbe de Bézier. PT_BEZIERTO types se produisent toujours dans les ensembles de trois. La position actuelle 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. Le point de fin devient la nouvelle position actuelle. S’il n’y a pas trois points de PT_BEZIERTO consécutifs, une erreur se produit.

Un type PT_LINETO ou PT_BEZIERTO peut être combiné 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 est fermée.

Valeur	Signification
PT_CLOSEFIGURE	Spécifie que la figure est automatiquement fermée après le type PT_LINETO ou PT_BEZIERTO pour ce point. Une ligne est dessinée de ce point à la PT_MOVETO la plus récente ou MoveToEx point. Cette valeur est combinée au type PT_LINETO d’une ligne ou au type PT_BEZIERTO du point de terminaison d’une courbe de Bézier, à l’aide de l’opérateur OR au niveau du bit. La position actuelle est définie sur le point de fin de la ligne fermante.

Valeur

Signification

PT_CLOSEFIGURE

Spécifie que la figure est automatiquement fermée après le type PT_LINETO ou PT_BEZIERTO pour ce point. Une ligne est dessinée de ce point à la PT_MOVETO la plus récente ou MoveToEx point.

Cette valeur est combinée au type PT_LINETO d’une ligne ou au type PT_BEZIERTO du point de terminaison d’une courbe de Bézier, à l’aide de l’opérateur OR au niveau du bit.

La position actuelle est définie sur le point de fin de la ligne fermante.

[in] cpt

Nombre total de points dans le tableau lppt, identique au nombre d’octets dans le tableau lpbTypes.

Valeur de retour

Si la fonction réussit, la valeur de retour est différente de zéro.

Si la fonction échoue, la valeur de retour est égale à zéro.

Remarques

La fonction PolyDraw peut être utilisée à la place d’appels consécutifs pour MoveToEx, LineToet fonctions PolyBezierTo pour dessiner des figures disjointes. Les lignes et les courbes sont dessinées à l’aide du stylet actuel et des figures ne sont pas remplies. S’il existe un chemin d’accès actif démarré en appelant BeginPath, PolyDraw ajoute au chemin d’accès.

Les points contenus dans le tableau lppt et dans le tableau lpbTypes indiquent si chaque point fait partie d’une opération MoveTo, LineToou PolyBezierTo opération. Il est également possible de fermer des chiffres.

Cette fonction met à jour la position actuelle.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
serveur minimum pris en charge	Windows 2000 Server [applications de bureau uniquement]
plateforme cible	Windows
d’en-tête	wingdi.h (include Windows.h)
bibliothèque	Gdi32.lib
DLL	Gdi32.dll