Graphics.Clear(Color) 方法

定義

命名空間:

System.Drawing

組件:

System.Drawing.Common.dll

套件:

System.Drawing.Common v8.0.0

來源:

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 Forms 使用，而且需要 PaintEventArgse，這是事件處理程序的參數Paint。 程序代碼會清除的 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 對象處於不一致的狀態。