Graphics.Clear(Color) メソッド

定義

名前空間:

System.Drawing

アセンブリ:

System.Drawing.Common.dll

パッケージ:

System.Drawing.Common v9.0.0-rc.2.24474.1

ソース:

Graphics.cs

描画サーフェイス全体をクリアし、指定した背景色で塗りつぶします。

public:
 void Clear(System::Drawing::Color color);

public void Clear (System.Drawing.Color color);

member this.Clear : System.Drawing.Color -> unit

Public Sub Clear (color As Color)

パラメーター

color

Color

描画サーフェイスの背景色。

例

次のコード例は Windows フォームで使用できるように設計されており、Paint イベント ハンドラーのパラメーターである PaintEventArgseが必要です。 このコードは、Graphics の描画サーフェイスをクリアし、背景色をシステム定義の青緑色に設定します。

private:
   void ClearColor( PaintEventArgs^ e )
   {
      // Clear screen with teal background.
      e->Graphics->Clear( Color::Teal );
   }

private void ClearColor(PaintEventArgs e)
{
    // Clear screen with teal background.
    e.Graphics.Clear(Color.Teal);
}

Private Sub ClearColor(ByVal e As PaintEventArgs)

    ' Clear screen with teal background.
    e.Graphics.Clear(Color.Teal)
End Sub

注釈

実際には、Clear メソッドは、指定された色の純色ブラシで領域を塗りつぶします。 指定した色の透明度が維持されます。

このメソッドはグラフィックス オブジェクトの状態をクリアし、グラフィックス オブジェクトを更新できない場合は呼び出さないでください。 たとえば、ターミナル サーバー セッションのセキュリティで保護されたデスクトップで Clear メソッドが呼び出されると、ExternalException が発生し、Graphics オブジェクトが不整合な状態のままになる可能性があります。