Graphics.Clear(Color) メソッド

定義

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

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

描画サーフェイスの背景色を表す 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.

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 グラフィックスオブジェクトの状態をクリアします。グラフィックスオブジェクトを更新できない場合には呼び出さないでください。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.

適用対象