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

[アーティクル]
02/26/2024

Graphics::ResetClip メソッドは、この Graphics オブジェクトのクリッピング領域を無限領域に設定します。

構文

Status ResetClip();

戻り値

種類: 状態

メソッドが成功した場合は、 Status 列挙体の要素である Ok を返します。

メソッドが失敗した場合は、 Status 列挙体の他の要素のいずれかを返します。

注釈

Graphics オブジェクトのクリッピング領域が無限の場合、その Graphics オブジェクトによって描画された項目はクリップされません。

例

次の例では、Graphics オブジェクトを作成し、そのクリッピング領域を四角形に設定します。このコードは、四角形のクリッピング領域と交差する 2 つの省略記号を塗りつぶします。最初の省略記号はクリップされますが、 Graphics::ResetClip の呼び出し後に塗りつぶされるため、2 番目の省略記号はクリップされません。

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

   // Set the clipping region, and draw its outline.
   graphics.SetClip(Rect(100, 50, 200, 120));
   Pen blackPen(Color(255, 0, 0, 0), 2.0f);
   graphics.DrawRectangle(&blackPen, 100, 50, 200, 120);

   // Fill a clipped ellipse in red.
   SolidBrush redBrush(Color(255, 255, 0, 0));
   graphics.FillEllipse(&redBrush, 80, 40, 100, 70);

   // Reset the clipping region.
   graphics.ResetClip();

   // Fill an unclipped ellipse with blue.
   SolidBrush blueBrush(Color(255, 0, 0, 255));
   graphics.FillEllipse(&blueBrush, 160, 150, 100, 60);
}

要件

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