Control.BackColor Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Obtém ou define a cor da tela de fundo do controle.
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
Valor da propriedade
Um Color que representa a cor da tela de fundo do controle. O padrão é o valor da propriedade DefaultBackColor.
Exemplos
O exemplo de código a seguir define o BackColor e ForeColor dos controles como as cores padrão do sistema. O código se chama recursivamente se o controle tiver controles filho. Este exemplo de código exige que você tenha um Form controle filho com pelo menos um; no entanto, um controle de contêiner filho, como um Panel ou GroupBox, com seus próprios controles filho, demonstraria melhor a recursão.
// 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
Comentários
A BackColor propriedade não dá suporte a cores transparentes, a menos que o SupportsTransparentBackColor
valor seja System.Windows.Forms.ControlStyles definido como true
.
A BackColor propriedade é uma propriedade ambiente. Uma propriedade de ambiente é uma propriedade de controle que, se não estiver definida, é recuperada do controle pai. Por exemplo, um Button terá o mesmo BackColor que seu pai Form por padrão. Para obter mais informações sobre propriedades de ambiente, consulte a AmbientProperties classe ou a visão geral da Control classe.
Notas aos Herdeiros
Ao substituir a BackColor propriedade em uma classe derivada, use a propriedade da BackColor classe base para estender a implementação base. Caso contrário, você deve fornecer toda a implementação. Você não precisa substituir os acessadores e set
os get
acessadores da BackColor propriedade; você pode substituir apenas um, se necessário.