Graphics.Clear(Color) Méthode

Définition

Espace de noms:

System.Drawing

Assembly:

System.Drawing.Common.dll

Paquet:

System.Drawing.Common v8.0.0

Source:

Graphics.cs

Efface l'intégralité de la surface de dessin et la remplit avec la couleur d'arrière-plan spécifiée.

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)

Paramètres

color

Color

Couleur d’arrière-plan de la surface de dessin.

Exemples

L’exemple de code suivant est conçu pour être utilisé avec Windows Forms et nécessite PaintEventArgse, qui est un paramètre du Paint gestionnaire d’événements. Le code efface la surface de dessin du Graphics et définit la couleur d’arrière-plan sur la couleur de sarcelle définie par le système.

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

Remarques

En effet, la Clear méthode remplit une zone avec un pinceau de couleur unie de la couleur spécifiée. La transparence de la couleur spécifiée est conservée.

Cette méthode efface l’état de l’objet graphics et ne doit pas être appelée lorsque l’objet graphics ne peut pas être mis à jour. Par exemple, si la Clear méthode est appelée sur un bureau sécurisé dans une session terminal server, une ExternalException peut se produire, laissant l’objet Graphics dans un état incohérent.