GraphicsPath::AddCurve(constPoint*,INT,REAL), méthode (gdipluspath.h)

Article
09/28/2022
2 minutes de lecture

La méthode GraphicsPath::AddCurve ajoute un spline cardinal à la figure actuelle de ce chemin.

Syntaxe

Status AddCurve(
  [in] const Point *points,
  [in] INT         count,
  [in] REAL        tension
);

Paramètres

[in] points

Type : point const *

Pointeur vers un tableau de points qui définissent le spline cardinal. Le spline cardinal est une courbe qui passe à 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 le 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 .

Remarques

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 AddClosedCurve ; Au lieu de cela, il convertit le spline cardinal 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 d’origine de points à partir de l’objet GraphicsPath .

Exemples

L’exemple suivant crée un objet GraphicsPath et appelle la méthode GraphicsPath::AddCurve pour ajouter un spline cardinal au chemin d’accès. Le troisième argument passé à GraphicsPath::AddCurve spécifie la tension du spline cardinal.

VOID AddCurveExample(HDC hdc)
{
   Graphics graphics(hdc);
   Point pts[] = {Point(50, 50),
                  Point(60, 20),
                  Point(70, 100),
                  Point(80, 50)};
   GraphicsPath path;
   path.AddCurve(pts, 4);
   // Draw the path.
   Pen pen(Color(255, 255, 0, 0));
   graphics.DrawPath(&pen, &path);   
}
Color(255, 255, 0,  0)

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