Graphics.Clear(Color) Metoda

Definice

Obor názvů:

System.Drawing

Sestavení:

System.Drawing.Common.dll

Balíček:

System.Drawing.Common v8.0.0

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í kreslicí plochy.

Příklady

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

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

Clear Ve skutečnosti metoda vyplní oblast plným barevným štětcem zadané barvy. Průhlednost zadané barvy je zachována.

Tato metoda vymaže stav grafického objektu a neměl 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 chybě ExternalException , která objekt ponechá Graphics v nekonzistentním stavu.