Graphics ::ResetClip, méthode (gdiplusgraphics.h)

Article
02/29/2024

La méthode Graphics ::ResetClip définit la zone de découpage de cet objet Graphics sur une région infinie.

Syntaxe

Status ResetClip();

Valeur de retour

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

Si la zone de découpage d’un objet Graphics est infinie, les éléments dessinés par cet objet Graphics ne sont pas clippés.

Exemples

L’exemple suivant crée un objet Graphics et définit sa zone de découpage sur un rectangle. Le code remplit deux ellipses qui croisent la zone de découpage rectangulaire. La première ellipse est clippée, mais la deuxième ellipse ne l’est pas, car elle est remplie après un appel à Graphics ::ResetClip.

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

   // Set the clipping region, and draw its outline.
   graphics.SetClip(Rect(100, 50, 200, 120));
   Pen blackPen(Color(255, 0, 0, 0), 2.0f);
   graphics.DrawRectangle(&blackPen, 100, 50, 200, 120);

   // Fill a clipped ellipse in red.
   SolidBrush redBrush(Color(255, 255, 0, 0));
   graphics.FillEllipse(&redBrush, 80, 40, 100, 70);

   // Reset the clipping region.
   graphics.ResetClip();

   // Fill an unclipped ellipse with blue.
   SolidBrush blueBrush(Color(255, 0, 0, 255));
   graphics.FillEllipse(&blueBrush, 160, 150, 100, 60);
}

Configuration requise

Condition requise	Valeur
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	gdiplusgraphics.h (include Gdiplus.h)
Bibliothèque	Gdiplus.lib
DLL	Gdiplus.dll