Graphics.Clear(Color) Metoda

Definice

Obor názvů:

System.Drawing

Sestavení:

System.Drawing.Common.dll

Balíček:

System.Drawing.Common v9.0.0-rc.2.24474.1

Zdroj:

Graphics.cs

Vymaže celou plochu výkresu a vyplní ji zadanou barvou pozadí.

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)

Parametry

color

Color

Barva pozadí nakresleného povrchu

Příklady

Následující příklad kódu je určený pro použití s Windows Forms a vyžaduje PaintEventArgse, což je parametr obslužné rutiny události Paint. Kód vymaže plochu výkresu Graphics a nastaví barvu pozadí na systémově definovanou teální barvu.

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

Poznámky

Metoda Clear efektivně vyplní oblast plnou barvou štětce zadané barvy. Průhlednost zadané barvy je zachována.

Tato metoda vymaže stav grafického objektu a neměla by být volána, pokud grafický objekt nelze aktualizovat. Pokud je například Clear metoda volána na zabezpečené ploše v relaci terminálového serveru, může dojít k ExternalException a ponechat objekt Graphics v nekonzistentním stavu.