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

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

Confira também

Recortando

Recorte com uma região

Métodos GetClipBounds

Elementos gráficos

Gráficos::GetClip

Graphics::IsVisibleClipEmpty

Graphics::ResetClip

Região

Métodos SetClip