Graphics.Clear(Color) Método

Definição

Namespace:

System.Drawing

Assembly:

System.Drawing.Common.dll

Pacote:

System.Drawing.Common v8.0.0

Origem:

Graphics.cs

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 Windows Forms e requer PaintEventArgse, que é um parâmetro do Paint manipulador de eventos. O código limpa a superfície de desenho do e define a cor da Graphics tela de fundo para a cor do 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 Clear método 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 Clear método for chamado em uma área de trabalho segura em uma sessão de servidor de terminal, poderá ocorrer um ExternalException , deixando o Graphics objeto em um estado inconsistente.