Graphics.Clear(Color) Méthode

Définition

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 de la Graphics couleur d’arrière-plan 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 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 graphique et ne doit pas être appelée lorsque l’objet graphique ne peut pas être mis à jour. Par exemple, si la Clear méthode est appelée sur un bureau sécurisé dans une session de serveur terminal, un ExternalException peut se produire, laissant l’objet Graphics dans un état incohérent.

S’applique à