Graphics.Clear(Color) Método

Definição

Limpa toda a superfície do desenho e preenche-a com a cor 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 de fundo da superfície de desenho.

Exemplos

O seguinte exemplo de código foi concebido para uso com Windows Forms e requer PaintEventArgse, que é um parâmetro do tratador de eventos Paint. O código limpa a superfície de desenho do Graphics e define a cor de fundo para a cor azul-petróleo 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

Observações

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

Este 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 Clear método for chamado num ambiente de trabalho seguro numa sessão de servidor de terminais, pode ocorrer un ExternalException , deixando o Graphics objeto num estado inconsistente.

Aplica-se a