Graphics.Clear(Color) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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 -> unitPublic 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.
