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

Artigo
08/24/2023

O método Graphics::IsClipEmpty determina se a região de recorte deste objeto Graphics está vazia.

Sintaxe

BOOL IsClipEmpty();

Valor retornado

Tipo: BOOL

Se a região de recorte de um objeto Graphics estiver vazia, esse método retornará TRUE; caso contrário, retornará FALSE.

Comentários

Se a região de recorte de um objeto Graphics estiver vazia, não haverá nenhuma área para desenhar. Consequentemente, nada será desenhado quando a região de recorte estiver vazia.

Exemplos

O exemplo a seguir determina se a região de recorte está vazia e, se não estiver, desenha um retâ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 com suporte	Windows XP, Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	gdiplusgraphics.h (inclua Gdiplus.h)
Biblioteca	Gdiplus.lib
DLL	Gdiplus.dll