Graphics.Clear(Color) Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
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.