Control.BackColor Propriété

Référence

Définition

Espace de noms:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

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.

Obtient ou définit la couleur d'arrière-plan du contrôle.

public:
 virtual property System::Drawing::Color BackColor { System::Drawing::Color get(); void set(System::Drawing::Color value); };

public virtual System.Drawing.Color BackColor { get; set; }

member this.BackColor : System.Drawing.Color with get, set

Public Overridable Property BackColor As Color

Valeur de propriété

Color

Color qui représente la couleur d'arrière-plan du contrôle. La valeur par défaut est la valeur de la propriété DefaultBackColor.

Exemples

L’exemple de code suivant définit les BackColor ForeColor contrôles sur les couleurs système par défaut. Le code s’appelle de façon récursive si le contrôle a des contrôles enfants. Cet exemple de code nécessite que vous ayez au moins un Form contrôle enfant ; toutefois, un contrôle conteneur enfant, comme un Panel ou GroupBox, avec ses propres contrôles enfants, illustre mieux la récursion.

   // Reset all the controls to the user's default Control color.
private:
   void ResetAllControlsBackColor( Control^ control )
   {
      control->BackColor = SystemColors::Control;
      control->ForeColor = SystemColors::ControlText;
      if ( control->HasChildren )
      {
         // Recursively call this method for each child control.
         IEnumerator^ myEnum = control->Controls->GetEnumerator();
         while ( myEnum->MoveNext() )
         {
            Control^ childControl = safe_cast<Control^>(myEnum->Current);
            ResetAllControlsBackColor( childControl );
         }
      }
   }

// Reset all the controls to the user's default Control color. 
private void ResetAllControlsBackColor(Control control)
{
   control.BackColor = SystemColors.Control;
   control.ForeColor = SystemColors.ControlText;
   if(control.HasChildren)
   {
      // Recursively call this method for each child control.
      foreach(Control childControl in control.Controls)
      {
         ResetAllControlsBackColor(childControl);
      }
   }
}

' Reset all the controls to the user's default Control color. 
Private Sub ResetAllControlsBackColor(control As Control)
   control.BackColor = SystemColors.Control
   control.ForeColor = SystemColors.ControlText
   If control.HasChildren Then
      ' Recursively call this method for each child control.
      Dim childControl As Control
      For Each childControl In  control.Controls
         ResetAllControlsBackColor(childControl)
      Next childControl
   End If
End Sub

Remarques

La BackColor propriété ne prend pas en charge les couleurs transparentes, sauf si la SupportsTransparentBackColor valeur de celle-ci System.Windows.Forms.ControlStyles est définie truesur .

La BackColor propriété est une propriété ambiante. Une propriété ambiante est une propriété de contrôle qui, si elle n’est pas définie, est récupérée à partir du contrôle parent. Par exemple, un Button aura le même BackColor que son parent Form par défaut. Pour plus d’informations sur les propriétés ambiantes, consultez la AmbientProperties classe ou la vue d’ensemble de la Control classe.

Notes pour les héritiers

Lors de la substitution de la BackColor propriété dans une classe dérivée, utilisez la propriété de BackColor la classe de base pour étendre l’implémentation de base. Sinon, vous devez fournir toute l’implémentation. Vous n’êtes pas obligé de remplacer les accesseurs et set les get accesseurs de la BackColor propriété ; vous ne pouvez remplacer qu’un seul si nécessaire.

S’applique à

Produit	Versions
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8
Windows Desktop	3.0, 3.1, 5, 6, 7

Partager via