Partilhar via


Graphics.Clear(Color) Método

Definição

Limpa toda a superfície de desenho e a preenche com a cor da tela de fundo especificada.

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

A cor da tela de fundo da superfície de desenho.

Exemplos

O exemplo de código a seguir foi projetado para uso com o Windows Forms e requer PaintEventArgse, que é um parâmetro do manipulador de eventos Paint. O código limpa a superfície de desenho do Graphics e define a cor da tela de fundo como a cor de teal definida pelo 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

Comentários

Efetivamente, o método Clear preenche uma área com um pincel de cor sólida da cor especificada. A transparência da cor especificada é mantida.

Esse método limpa o estado do objeto gráfico e não deve ser chamado quando o objeto gráfico não pode ser atualizado. Por exemplo, se o método Clear for chamado em uma área de trabalho segura em uma sessão de servidor de terminal, uma ExternalException poderá ocorrer, deixando o objeto Graphics em um estado inconsistente.

Aplica-se a