Graphics.Clear(Color) 方法

定義

命名空間:

System.Drawing

組件:

System.Drawing.Common.dll

來源:

Graphics.cs

清除整個繪圖表面，並以指定的背景色彩填滿它。

C#

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

參數

color

Color

繪圖介面的背景色彩。

範例

下列程式代碼範例是專為搭配 Windows Forms 使用而設計，而且需要 PaintEventArgse，這是 Paint 事件處理程式的參數。 程序代碼會清除 Graphics 的繪圖表面，並將背景色彩設定為系統定義的teal色彩。

C#

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

備註

實際上，Clear 方法會以指定色彩的純色筆刷填滿區域。 會保留指定色彩的透明度。

這個方法會清除圖形物件的狀態，而且不應該在無法更新圖形物件時呼叫。 例如，如果在終端機伺服器會話的安全桌面上呼叫 Clear 方法，可能會發生 ExternalException，使 Graphics 對象處於不一致的狀態。

適用於