Graphics.Clear(Color) Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee wist u het volledige tekenoppervlak en vult u het met de opgegeven achtergrondkleur.
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)
Parameters
- color
- Color
De achtergrondkleur van het tekenoppervlak.
Voorbeelden
Het volgende codevoorbeeld is ontworpen voor gebruik met Windows Forms en vereist PaintEventArgse, een parameter van de Paint gebeurtenis-handler. De code wist het tekenoppervlak van de Graphics en stelt de achtergrondkleur in op de door het systeem gedefinieerde groenkleur.
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
Opmerkingen
In feite vult de Clear methode een gebied met een effen kleurborstel van de opgegeven kleur. De transparantie van de opgegeven kleur wordt gehandhaafd.
Deze methode wist de status van het grafische object en mag niet worden aangeroepen wanneer het grafische object niet kan worden bijgewerkt. Als de Clear methode bijvoorbeeld wordt aangeroepen op een beveiligd bureaublad in een terminalserversessie, kan er een ExternalException optreden, waardoor het Graphics object een inconsistente status heeft.