Graphics.Clear(Color) Método

Definición

Espacio de nombres:

System.Drawing

Ensamblado:

System.Drawing.Common.dll

Paquete:

System.Drawing.Common v9.0.0-preview.5.24306.5

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 controlador de eventos Paint. El código borra la superficie de dibujo del Graphics y establece el color de 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 método Clear 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 método Clear en un escritorio seguro en una sesión de terminal server, puede producirse un ExternalException, dejando el objeto Graphics en un estado incoherente.