Graphics.Clear(Color) Methode

Definition

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

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 wurde für die Verwendung mit Windows Forms entwickelt und erfordert PaintEventArgse, bei dem es sich um einen Parameter des Paint-Ereignishandlers handelt. Der Code löscht die Zeichnungsoberfläche des Graphics und legt die Hintergrundfarbe auf die vom System definierte 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 Volltonfarbpinsel der angegebenen Farbe. 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 beispielsweise die Clear-Methode auf einem sicheren Desktop in einer Terminalserversitzung aufgerufen wird, kann ein ExternalException auftreten, sodass das Graphics-Objekt in einem inkonsistenten Zustand bleibt.

Gilt für: