Graphics.Clear(Color) 方法

定义

命名空间:

System.Drawing

程序集:

System.Drawing.Common.dll

包:

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

Source:

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 窗体，它需要 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 对象处于不一致状态。