Graphics.Clear(Color) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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 -> unitPublic 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.
