Graphics.Clear(Color) Méthode

Définition

Espace de noms:

System.Drawing

Assembly:

System.Drawing.Common.dll

Paquet:

System.Drawing.Common v9.0.0-preview.6.24327.6

Source:

Graphics.cs

Efface toute 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 l’aire 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 gestionnaire d’événements Paint. Le code efface la surface de dessin du Graphics et définit la couleur d’arrière-plan sur la couleur de téale 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 fait, la méthode Clear 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 graphique et ne doit pas être appelée lorsque l’objet graphique ne peut pas être mis à jour. Par exemple, si la méthode Clear est appelée sur un bureau sécurisé dans une session de serveur terminal, une ExternalException peut se produire, laissant l’objet Graphics dans un état incohérent.