Graphics.Clear(Color) Methode

Definition

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

Color-Struktur, die die Hintergrundfarbe der Zeichenoberfläche darstellt.

Beispiele

Das folgende Codebeispiel ist für die Verwendung mit Windows Forms konzipiert und erfordert PaintEventArgse, ein Parameter des Paint Ereignishandlers. 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

Die Clear -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.

Gilt für