Graphics.Clear(Color) Graphics.Clear(Color) Graphics.Clear(Color) Method


描画サーフェイス全体を消去し、指定した背景色で塗りつぶします。Clears the entire drawing surface and fills it with the specified background color.

 void Clear(System::Drawing::Color color);
public void Clear (System.Drawing.Color color);
member this.Clear : System.Drawing.Color -> unit


Color Color Color

描画サーフェイスの背景色を表す Color 構造体。Color structure that represents the background color of the drawing surface.

次のコード例は、Windows フォームで使用するために設計されています。 また必要がPaintEventArgs e、はのパラメーター、Paintイベント ハンドラー。The following code example is designed for use with Windows Forms, and it requires PaintEventArgse, which is a parameter of the Paint event handler. 描画サーフェイスを消去する、コード、Graphicsおよび青緑のシステム定義色を背景色を設定します。The code clears the drawing surface of the Graphics and sets the background color to the system-defined teal color.

   void ClearColor( PaintEventArgs^ e )
      // Clear screen with teal background.
      e->Graphics->Clear( Color::Teal );
private void ClearColor(PaintEventArgs e)
    // Clear screen with teal background.
Private Sub ClearColor(ByVal e As PaintEventArgs)

    ' Clear screen with teal background.
End Sub


Clearメソッドは、グラフィックス オブジェクトの状態をクリアし、グラフィックス オブジェクトを更新することはできませんと呼び出されません。The Clear method clears the state of the graphics object and should not be called when the graphics object cannot be updated. たとえば場合、 Clear 、ターミナル サーバー セッションをセキュリティで保護されたデスクトップでメソッドが呼び出される、ExternalExceptionが発生すると、終了、Graphics矛盾した状態オブジェクト。For example, if the Clear method is called on a secure desktop in a terminal server session, an ExternalException may occur, leaving the Graphics object in an inconsistent state.