GraphicsPath::Outline, méthode (gdipluspath.h)

Article
08/24/2023

La méthode GraphicsPath::Outline transforme et aplatit ce chemin, puis convertit les points de données de ce chemin afin qu’ils représentent uniquement le contour du chemin.

Syntaxe

Status Outline(
  [in] const Matrix *matrix,
  [in] REAL         flatness
);

Paramètres

[in] matrix

Type : const Matrix*

Optionnel. Pointeur vers un objet Matrix qui spécifie la transformation. Si ce paramètre a la valeur NULL, aucune transformation n’est appliquée. La valeur par défaut est NULL.

[in] flatness

Type : REAL

Optionnel. Nombre réel qui spécifie l’erreur maximale entre le chemin et son approximation aplatisse. La réduction de la platité augmente le nombre de segments de ligne dans l’approximation. La valeur par défaut est FlatnessDefault, qui est une constante définie dans Gdiplusenums.h.

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

Un objet GraphicsPath stocke une collection de points de données qui représentent des lignes et des courbes. La méthode GraphicsPath::Outline modifie ces points de données et les points de données d’origine sont perdus.

Exemples

L’exemple suivant crée un objet GraphicsPath et appelle la méthode GraphicsPath::AddClosedCurve pour ajouter une spline cardinale fermée au chemin d’accès. Le code appelle la méthode GraphicsPath::Widen pour élargir le chemin, puis dessine le chemin. Ensuite, le code appelle la méthode Outline du chemin d’accès. Le code appelle la méthode TranslateTransform d’un objet Graphics afin que le chemin tracé par l’appel suivant à DrawPath se trouve à droite du premier chemin.


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

   Pen bluePen(Color(255, 0, 0, 255));
   Pen greenPen(Color(255, 0, 255,  0), 10);

   PointF points[] = {
      PointF(20.0f, 20.0f),
      PointF(160.0f, 100.0f),
      PointF(140.0f, 60.0f),
      PointF(60.0f, 100.0f)};

   GraphicsPath path;
   path.AddClosedCurve(points, 4);

   path.Widen(&greenPen);
   graphics.DrawPath(&bluePen, &path);

   path.Outline();

   graphics.TranslateTransform(180.0f, 0.0f);
   graphics.DrawPath(&bluePen, &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