Control.ForeColor Propriété
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.
Obtient ou définit la couleur de premier plan du contrôle.
public:
virtual property System::Drawing::Color ForeColor { System::Drawing::Color get(); void set(System::Drawing::Color value); };
public virtual System.Drawing.Color ForeColor { get; set; }
member this.ForeColor : System.Drawing.Color with get, set
Public Overridable Property ForeColor As Color
Valeur de propriété
Color de premier plan du contrôle. La valeur par défaut est la valeur de la propriété DefaultForeColor.
Exemples
L’exemple de code suivant définit les BackColor ForeColor couleurs système par défaut et les contrôles. Le code s’appelle de manière récursive si le contrôle a des contrôles enfants. Cet exemple de code nécessite que vous disposiez d’au Form moins un contrôle enfant ; toutefois, un contrôle conteneur enfant, comme un Panel ou GroupBox, avec son ou ses propres contrôles enfants, illustrerait mieux la récursivité.
// 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 ForeColor propriété est une propriété ambiante. Une propriété ambiante est une propriété de contrôle qui, s’il n’est pas défini, est récupérée à partir du contrôle parent. Par exemple, une Button valeur aura la même BackColor valeur 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
En cas de substitution de la ForeColor propriété dans une classe dérivée, utilisez la propriété de la classe de ForeColor 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 ForeColor propriété ; vous ne pouvez remplacer qu’un seul si nécessaire.