Partager via


CDC::PolyDraw

Dessine un ensemble de segments et de splines de Bézier de ligne.

BOOL PolyDraw(
   const POINT* lpPoints,
   const BYTE* lpTypes,
   int nCount 
);

Paramètres

  • lpPoints
    Pointe vers un tableau de structures de données de POINT qui contient les points de terminaison pour chaque segment de ligne et les points de terminaison et les points de contrôle pour chaque spline de Bézier.

  • lpTypes
    Pointe vers un tableau qui spécifie la manière dont chaque point de la matrice d' lpPoints est utilisé.Les valeurs peuvent être l'une des opérations suivantes :

    • PT_MOVETO spécifie que ce point démarre un chiffre de disjonction.Ce point est la nouvelle position actuelle.

    • PT_LINETO spécifie qu'une ligne doit être effectuée de la position actuelle à présent, qui est ensuite la nouvelle position actuelle.

    • PT_BEZIERTO spécifie que ce point est un point de contrôle ou un point de fin d'une spline de Bézier.

      Les types dePT_BEZIERTO se produisent toujours dans les ensembles de trois.La position actuelle définit le point de départ pour la spline de Bézier.Les deux premiers points de PT_BEZIERTO sont les points de contrôle, et le troisième point de PT_BEZIERTO est le point de terminaison.Le point de terminaison devient la nouvelle position actuelle.S'il n'y a pas de trois points consécutifs de PT_BEZIERTO , les résultats des erreurs.

      Un type de PT_LINETO ou de PT_BEZIERTO peut être combiné avec la constante suivante à l'aide de l'opérateur de bits OR indiquer que le point correspondant est le dernier point dans une illustration et l'illustration est fermée :

    • PT_CLOSEFIGURE spécifie que l'illustration est automatiquement fermée après que le type de PT_LINETO ou de PT_BEZIERTO pour ce point soit effectué.Une courbe est tracée à partir de ce point à PT_MOVETO ou au point d' MoveTo le plus récent.

      Cette balise est combinée avec le type de PT_LINETO pour une ligne, ou avec le type de PT_BEZIERTO de point de terminaison pour une spline de Bézier, à l'aide de bits de l'opérateur d' OR .La position actuelle a pour valeur le point de terminaison de la ligne de fin.

  • nCount
    Spécifie le nombre de points dans le tableau d' lpPoints , la même que le nombre d'octets dans le tableau d' lpTypes .

Valeur de retour

Une valeur différente de zéro si la fonction est réussie ; sinon 0.

Notes

Cette fonction peut être utilisée pour dessiner disjoignent des illustrations à la place des appels consécutifs à CDC::MoveTo, à CDC::LineTo, et les fonctions membres d' CDC::PolyBezierTo .Les lignes et les splines sont dessinés avec le stylet actuel, et les illustrations ne sont pas respectées.Si un chemin actif démarré en appelant la fonction membre d' CDC::BeginPath , PolyDraw ajoute au chemin d'accès.Les points contenus dans le tableau d' lpPoints et dans lpTypes indiquent si chaque point fait partie d' CDC::MoveTo, d' CDC::LineTo, ou d'une opération de CDC::BezierTo .Il est également possible de fermer des illustrations.Cette fonction met à jour la position actuelle.

Exemple

Consultez l'exemple pour CDC::BeginPath.

Configuration requise

Header: afxwin.h

Voir aussi

Référence

CDC, classe

Graphique de la hiérarchie

CDC::BeginPath

CDC::EndPath

CDC::LineTo

CDC::MoveTo

CDC::PolyBezierTo

CDC::Polyline

PolyDraw