GraphicsPath::AddClosedCurve(constPointF*,INT,REAL) , méthode (gdipluspath.h)

La méthode GraphicsPath::AddClosedCurve ajoute une spline cardinale fermée à ce chemin.

Syntaxe

Status AddClosedCurve(
  [in] const PointF *points,
  [in] INT          count,
  [in] REAL         tension
);

Paramètres

[in] points

Type : const PointF*

Pointeur vers un tableau de points qui définissent la spline cardinale. La spline cardinale est une courbe qui traverse chaque point du tableau.

[in] count

Type : INT

Entier qui spécifie le nombre d’éléments dans le tableau de points .

[in] tension

Type : REAL

Nombre réel non négatif qui contrôle la longueur de la courbe et la façon dont la courbe se plie. La valeur 0 spécifie que la spline est une séquence de segments de ligne droite. À mesure que la valeur augmente, la courbe devient plus complète.

Valeur retournée

Type : État

Si la méthode réussit, elle retourne Ok, qui est un élément de l’énumération Status .

Si la méthode échoue, elle retourne l’un des autres éléments de l’énumération Status .

Notes

Vous devez conserver une copie du tableau de points si ces points seront nécessaires ultérieurement. L’objet GraphicsPath ne stocke pas les points passés à la méthode GraphicsPath::AddClosedCurve ; au lieu de cela, il convertit la spline cardinale en une séquence de splines de Bézier et stocke les points qui définissent ces splines de Bézier. Vous ne pouvez pas récupérer le tableau de points d’origine à partir de l’objet GraphicsPath .

Exemples

L’exemple suivant crée un chemin d’objet GraphicsPath, ajoute une spline cardinale fermée au chemin, puis dessine le chemin. La tension est définie sur 1.0.

VOID Example_AddClosedCurve(HDC hdc)
{
   Graphics graphics(hdc); 

   PointF pts[] = {PointF(50.0f,50.0f),
                   PointF(60.0f,20.0f),
                   PointF(70.0f,100.0f),
                   PointF(80.0f,50.0f)};

   GraphicsPath path;
   path.AddClosedCurve(pts, 4, 1.0f);

   // Draw the path.
   Pen pen(Color(255, 255, 0, 0));
   graphics.DrawPath(&pen, &path);
}

Configuration requise

   
Client minimal pris en charge Windows XP, 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 gdipluspath.h (include Gdiplus.h)
Bibliothèque Gdiplus.lib
DLL Gdiplus.dll

Voir aussi

Méthodes AddBezier

AddBeziers, méthodes

AddClosedCurve, méthodes

Méthodes AddCurve

Splines cardinales

Découpage avec une région

Génération et dessin de tracés

Création d’un dégradé de chemin

Splines cardinales de dessin

Graphicspath

Chemins d’accès

Pointf