Graphics.Clear(Color) Metodo

Definizione

Spazio dei nomi:

System.Drawing

Assembly:

System.Drawing.Common.dll

Pacchetto:

System.Drawing.Common v8.0.0

Origine:

Graphics.cs

Cancella il contenuto dell'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 Paint gestore eventi. Il codice cancella la superficie di disegno di Graphics e imposta il colore di sfondo sul colore teal 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. Viene mantenuta la trasparenza del colore specificato.

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'eccezione ExternalException , lasciando l'oggetto Graphics in uno stato incoerente.