Graphics.Clear(Color) Método

Definición

Espacio de nombres:

System.Drawing

Ensamblado:

System.Drawing.Common.dll

Paquete:

System.Drawing.Common v8.0.0

Source:

Graphics.cs

Borra toda la superficie de dibujo y la rellena con el color de fondo especificado.

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)

Parámetros

color

Color

Color de fondo de la superficie de dibujo.

Ejemplos

El ejemplo de código siguiente está diseñado para su uso con Windows Forms y requiere PaintEventArgse, que es un parámetro del Paint controlador de eventos. El código borra la superficie de dibujo de y establece el color de Graphics fondo en el color de teal definido por el sistema.

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

Comentarios

De hecho, el Clear método rellena un área con un pincel de color sólido del color especificado. Se mantiene la transparencia del color especificado.

Este método borra el estado del objeto gráfico y no se debe llamar cuando no se puede actualizar el objeto gráfico. Por ejemplo, si se llama al Clear método en un escritorio seguro en una sesión de terminal server, puede producirse una ExternalException excepción , dejando el Graphics objeto en un estado incoherente.