Graphics.Clear(Color) Metodo

Definizione

Cancella l'intera superficie di disegno e la riempie con il colore di sfondo specificato.

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)

Parametri

color
Color

Colore di sfondo della superficie di disegno.

Esempio

L'esempio di codice seguente è progettato per l'uso con Windows Forms e richiede PaintEventArgse, che è un parametro del gestore eventi Paint. Il codice cancella la superficie di disegno di e imposta il colore di Graphics sfondo sul colore teale definito dal 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

Commenti

In effetti, il Clear metodo riempie un'area con un pennello a tinta unita del colore specificato. La trasparenza del colore specificato viene mantenuta.

Questo metodo cancella lo stato dell'oggetto grafico e non deve essere chiamato quando l'oggetto grafico non può essere aggiornato. Ad esempio, se il Clear metodo viene chiamato su un desktop protetto in una sessione del server terminal, può verificarsi un'operazione ExternalException , lasciando l'oggetto Graphics in uno stato incoerente.

Si applica a