Método Graphics::ResetClip (gdiplusgraphics.h)

Artículo
02/26/2024

El método Graphics::ResetClip establece la región de recorte de este objeto Graphics en una región infinita.

Sintaxis

Status ResetClip();

Valor devuelto

Tipo: Estado

Si el método se realiza correctamente, devuelve Ok, que es un elemento de la enumeración Status .

Si se produce un error en el método, devuelve uno de los otros elementos de la enumeración Status .

Comentarios

Si la región de recorte de un objeto Graphics es infinita, los elementos dibujados por ese objeto Graphics no se recortarán.

Ejemplos

En el ejemplo siguiente se crea un objeto Graphics y se establece su región de recorte en un rectángulo. El código rellena dos puntos suspensivos que cruzan la región de recorte rectangular. La primera elipse se recorta, pero la segunda elipse no se recorta porque se rellena después de una llamada a 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);
}

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP, Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	gdiplusgraphics.h (include Gdiplus.h)
Library	Gdiplus.lib
Archivo DLL	Gdiplus.dll