Graphics.Clear(Color) Methode

Definition

Namespace:

System.Drawing

Assembly:

System.Drawing.Common.dll

Paket:

System.Drawing.Common v8.0.0

Quelle:

Graphics.cs

Löscht die gesamte Zeichenoberfläche und füllt sie mit der angegebenen Hintergrundfarbe aus.

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)

Parameter

color

Color

Die Hintergrundfarbe der Zeichnungsoberfläche.

Beispiele

Das folgende Codebeispiel ist für die Verwendung mit Windows Forms konzipiert und erfordert PaintEventArgse, was ein Parameter des Paint Ereignishandlers ist. Der Code löscht die Zeichnungsoberfläche von Graphics und legt die Hintergrundfarbe auf die systemdefinierte Tealfarbe fest.

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

Hinweise

Effektiv füllt die Clear -Methode einen Bereich mit einem Volltonpinsel der angegebenen Farbe aus. Die Transparenz der angegebenen Farbe wird beibehalten.

Diese Methode löscht den Zustand des Grafikobjekts und sollte nicht aufgerufen werden, wenn das Grafikobjekt nicht aktualisiert werden kann. Wenn die Clear -Methode z. B. auf einem sicheren Desktop in einer Terminalserversitzung aufgerufen wird, kann eine ExternalException auftreten, wodurch das Graphics Objekt in einem inkonsistenten Zustand bleibt.