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

Graphics::IsVisibleClipEmpty メソッドは、この Graphics オブジェクトの表示領域が空かどうかを決定します。 表示されるクリッピング領域は、この Graphics オブジェクトのクリッピング領域とウィンドウのクリッピング領域の交差部分です。

構文

BOOL IsVisibleClipEmpty();

戻り値

種類: BOOL

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

解説

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

例

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

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

要件