Graphics.Clear(Color) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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 -> unitPublic 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.
