Graphics.Clear(Color) Metodo

Definizione

Spazio dei nomi:

System.Drawing

Assembly:

System.Drawing.Common.dll

Pacchetto:

System.Drawing.Common v9.0.0-rc.2.24474.1

Origine:

Graphics.cs

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 Form e richiede PaintEventArgse, che è un parametro del gestore eventi Paint. Il codice cancella la superficie di disegno del Graphics e imposta il colore di sfondo sul colore verde verde 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 metodo Clear 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 metodo Clear viene chiamato su un desktop protetto in una sessione del server terminal, può verificarsi un ExternalException, lasciando l'oggetto Graphics in uno stato incoerente.