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

O método Graphics::IsVisibleClipEmpty determina se a região de recorte visível deste objeto Graphics está vazia. A região de recorte visível é a interseção da região de recorte deste objeto Graphics e da região de recorte da janela.

Sintaxe

BOOL IsVisibleClipEmpty();

Valor retornado

Tipo: BOOL

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

Comentários

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

Exemplos

O exemplo a seguir determina se a região de recorte visível está vazia. Se não estiver vazio, ele desenhará um retângulo.

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

   // If the clipping region is not empty, draw a rectangle.
   if (!graphics.IsVisibleClipEmpty())
   {
   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