Graphics.Clear(Color) Metodo

Definizione

Cancella il contenuto dell'intera superficie di disegno e la riempie con il colore di sfondo specificato.Clears the entire drawing surface and fills it with the specified background color.

public:
 void Clear(System::Drawing::Color color);
public void Clear (System.Drawing.Color color);
member this.Clear : System.Drawing.Color -> unit

Parametri

color
Color

Struttura Color che rappresenta il colore di sfondo della superficie di disegno.Color structure that represents the background color of the drawing surface.

Esempi

L'esempio di codice seguente è progettato per l'uso con Windows Forms e richiede PaintEventArgs e, che Paint è un parametro del gestore eventi.The following code example is designed for use with Windows Forms, and it requires PaintEventArgse, which is a parameter of the Paint event handler. Il codice Cancella la superficie di disegno di Graphics e imposta il colore di sfondo sul colore verde acqua definito dal sistema.The code clears the drawing surface of the Graphics and sets the background color to the system-defined teal color.

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

Il Clear metodo cancella lo stato dell'oggetto Graphics e non deve essere chiamato quando l'oggetto Graphics non può essere aggiornato.The Clear method clears the state of the graphics object and should not be called when the graphics object cannot be updated. Se, ad esempio, Clear il metodo viene chiamato su un desktop protetto in una sessione di Terminal Server ExternalException , è possibile che si Graphics verifichi un errore, lasciando l'oggetto in uno stato incoerente.For example, if the Clear method is called on a secure desktop in a terminal server session, an ExternalException may occur, leaving the Graphics object in an inconsistent state.

Si applica a