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

Artículo
03/11/2023

El método Graphics::IsClipEmpty determina si la región de recorte de este objeto Graphics está vacía.

Sintaxis

BOOL IsClipEmpty();

Valor devuelto

Tipo: BOOL

Si la región de recorte de un objeto Graphics está vacía, este método devuelve TRUE; de lo contrario, devuelve FALSE.

Comentarios

Si la región de recorte de un objeto Graphics está vacía, no queda ningún área en la que dibujar. Por lo tanto, no se dibujará nada cuando la región de recorte esté vacía.

Ejemplos

En el ejemplo siguiente se determina si la región de recorte está vacía y, si no es así, dibuja un rectángulo.

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

   // If the clipping region is not empty, draw a rectangle.
   if (!graphics.IsClipEmpty())
   {
   graphics.DrawRectangle(&Pen(Color(255, 0, 0, 0), 3), 0, 0, 100, 100);
   }
}

Requisitos


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