Control.BackColor Eigenschaft
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft die Hintergrundfarbe für das Steuerelement ab oder legt diese fest.
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, setPublic Overridable Property BackColor As ColorEine Color, die die Hintergrundfarbe des Steuerelements darstellt. Der Standardwert ist der Wert der DefaultBackColor-Eigenschaft.
Im folgenden Codebeispiel werden die BackColor ForeColor Steuerelemente auf die Standardsystemfarben festgelegt. Der Code ruft sich rekursiv selbst auf, wenn das Steuerelement über untergeordnete Steuerelemente verfügt. In diesem Codebeispiel ist erforderlich, dass Sie mindestens ein untergeordnetes Steuerelement haben Form . Ein untergeordnetes Containersteuerelement wie ein Panel oder GroupBoxein untergeordnetes Steuerelement mit einem eigenen untergeordneten Steuerelement würde jedoch besser veranschaulichen.
// 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
Die BackColor Eigenschaft unterstützt keine transparenten Farben, es sei denn, der SupportsTransparentBackColor Wert System.Windows.Forms.ControlStyles ist auf truefestgelegt.
Die BackColor Eigenschaft ist eine Umgebungseigenschaft. Eine Umgebungseigenschaft ist eine Steuerelementeigenschaft, die, wenn nicht festgelegt, aus dem übergeordneten Steuerelement abgerufen wird. Beispielsweise hat ein Button Element standardmäßig das gleiche BackColor wie sein übergeordnetes Form Element. Weitere Informationen zu Umgebungseigenschaften finden Sie in der AmbientProperties Klassen- oder Klassenübersicht Control .
Verwenden Sie beim Außerkraftsetzen der Eigenschaft in einer abgeleiteten Klasse die BackColor Basisklasse, um die Basisimplementierung BackColor zu erweitern. Andernfalls müssen Sie alle Implementierungen bereitstellen. Sie sind nicht erforderlich, um sowohl die Accessoren als auch die get set Zugriffsoren der BackColor Eigenschaft außer Kraft zu setzen. Sie können nur eine außer Kraft setzen, wenn sie erforderlich ist.
| Produkt | Versionen |
|---|---|
| .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 |