Graphics.Clear(Color) Graphics.Clear(Color) Graphics.Clear(Color) Method

Definición

Borra toda la superficie de dibujo y la rellena con el color de fondo especificado.Clears the entire drawing surface and fills it with the specified background color.

public:
 void Clear(System::Drawing::Color color);
public void Clear (System.Drawing.Color color);
member this.Clear : System.Drawing.Color -> unit

Parámetros

color
Color Color Color

Estructura Color que representa el color de fondo de la superficie de dibujo.Color structure that represents the background color of the drawing surface.

Ejemplos

El siguiente ejemplo de código está diseñado para su uso con Windows Forms y requiere PaintEventArgs e, que Paint es un parámetro del controlador de eventos.The following code example is designed for use with Windows Forms, and it requires PaintEventArgse, which is a parameter of the Paint event handler. El código borra la superficie de dibujo del Graphics y establece el color de fondo en el color verde azulado definido por el sistema.The code clears the drawing surface of the Graphics and sets the background color to the system-defined teal color.

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

El Clear método borra el estado del objeto Graphics y no debe llamarse cuando no se puede actualizar el objeto Graphics.The Clear method clears the state of the graphics object and should not be called when the graphics object cannot be updated. Por ejemplo, si se Clear llama al método en un escritorio seguro en una sesión de Terminal Server, ExternalException puede producirse una excepción Graphics , lo que mantiene el objeto en un estado incoherente.For example, if the Clear method is called on a secure desktop in a terminal server session, an ExternalException may occur, leaving the Graphics object in an inconsistent state.

Se aplica a