Graphics::IsClipEmpty-Methode (gdiplusgraphics.h)

Artikel
08/24/2023

Die Graphics::IsClipEmpty-Methode bestimmt, ob der Beschneidungsbereich dieses Graphics-Objekts leer ist.

Syntax

BOOL IsClipEmpty();

Rückgabewert

Typ: BOOL

Wenn der Beschneidungsbereich eines Graphics-Objekts leer ist, gibt diese Methode TRUE zurück. Andernfalls wird FALSE zurückgegeben.

Hinweise

Wenn der Beschneidungsbereich eines Graphics-Objekts leer ist, gibt es keinen Bereich mehr, in dem gezeichnet werden kann. Folglich wird nichts gezeichnet, wenn der Beschneidungsbereich leer ist.

Beispiele

Im folgenden Beispiel wird bestimmt, ob der Beschneidungsbereich leer ist, und zeichnet, falls nicht, ein Rechteck.

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);
   }
}

Anforderungen


Unterstützte Mindestversion (Client)	Windows XP, Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	gdiplusgraphics.h (include Gdiplus.h)
Bibliothek	Gdiplus.lib
DLL	Gdiplus.dll