Graphics.Clear(Color) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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 -> unitPublic 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.
