Graphics.Clear(Color) Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Czyści całą powierzchnię rysunku i wypełnia ją określonym kolorem tła.
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
Kolor tła powierzchni rysunku.
Przykłady
Poniższy przykład kodu jest przeznaczony do użycia z formularzami Systemu Windows i wymaga PaintEventArgse
, który jest parametrem programu obsługi zdarzeń Paint. Kod czyści powierzchnię rysunku Graphics i ustawia kolor tła na zdefiniowany przez system kolor tealny.
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
Uwagi
W rzeczywistości metoda Clear wypełnia obszar pędzlem o określonym kolorze. Przezroczystość określonego koloru jest utrzymywana.
Ta metoda czyści stan obiektu graficznego i nie powinien być wywoływany, gdy nie można zaktualizować obiektu graficznego. Jeśli na przykład metoda Clear jest wywoływana na bezpiecznym pulpicie w sesji serwera terminali, może wystąpić ExternalException, pozostawiając obiekt Graphics w stanie niespójnym.