Graphics::IsClipEmpty メソッド (gdiplusgraphics.h)

Graphics::IsClipEmpty メソッドは、この Graphics オブジェクトのクリッピング領域が空かどうかを判断します。

構文

BOOL IsClipEmpty();

戻り値

種類: BOOL

Graphics オブジェクトのクリッピング領域が空の場合、このメソッドは TRUE を返します。それ以外の場合は、FALSE を返します。

解説

Graphics オブジェクトのクリッピング領域が空の場合、描画する領域は残っていません。 したがって、クリッピング領域が空の場合、何も描画されません。

例

次の例では、クリッピング領域が空かどうかを判断し、空でない場合は四角形を描画します。

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

要件

サポートされている最小のクライアント	Windows XP、Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	gdiplusgraphics.h (Gdiplus.h を含む)
Library	Gdiplus.lib
[DLL]	Gdiplus.dll

関連項目

クリッピング

領域を使用したクリッピング

GetClipBounds メソッド

グラフィックス

Graphics::GetClip

Graphics::IsVisibleClipEmpty

Graphics::ResetClip

リージョン

SetClip メソッド