Graphics.Clear(Color) Graphics.Clear(Color) Graphics.Clear(Color) Method

Определение

Очищает всю поверхность рисования и выполняет заливку поверхности указанным цветом фона.Clears the entire drawing surface and fills it with the specified background color.

public:
 void Clear(System::Drawing::Color color);
public void Clear (System.Drawing.Color color);
member this.Clear : System.Drawing.Color -> unit

Параметры

color
Color Color Color

Структура Color, которая представляет собой цвет фона для поверхности рисования.Color structure that represents the background color of the drawing surface.

Примеры

Следующий пример кода предназначен для использования с Windows Forms и требует PaintEventArgs e, что Paint является параметром обработчика событий.The following code example is designed for use with Windows Forms, and it requires PaintEventArgse, which is a parameter of the Paint event handler. Код очищает поверхность Graphics рисования и задает цвет фона для определенного системой цвета.The code clears the drawing surface of the Graphics and sets the background color to the system-defined teal color.

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

Комментарии

Clear Метод очищает состояние графического объекта и не должен вызываться, когда графический объект не может быть обновлен.The Clear method clears the state of the graphics object and should not be called when the graphics object cannot be updated. Например, если Clear метод вызывается на защищенном рабочем столе в сеансе сервера терминалов, Graphics может ExternalException произойти исключение, при котором объект остается в нестабильном состоянии.For example, if the Clear method is called on a secure desktop in a terminal server session, an ExternalException may occur, leaving the Graphics object in an inconsistent state.

Применяется к