Graphics.Clear(Color) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Очищает всю поверхность рисования и заполняет ее указанным цветом фона.
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)
Параметры
- color
- Color
Цвет фона поверхности рисования.
Примеры
Следующий пример кода предназначен для использования с Windows Forms и требует PaintEventArgse
, который является параметром обработчика событий Paint. Код очищает поверхность рисования Graphics и задает цвет фона для определенного системой цвета подростка.
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 заполняет область сплошной кистью указанного цвета. Прозрачность указанного цвета сохраняется.
Этот метод очищает состояние графического объекта и не должен вызываться, если графический объект не может быть обновлен. Например, если метод Clear вызывается на защищенном рабочем столе в сеансе сервера терминала, может возникнуть ExternalException, оставив объект Graphics в несогласованном состоянии.