Control.BackColor Propriedade

Definição

Espaço de Nomes:

System.Windows.Forms

Assemblagem:

System.Windows.Forms.dll

Obtém ou define a cor de fundo do controlo.

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 de Propriedade

Color

A Color que representa a cor de fundo do controlo. O valor padrão é o valor da DefaultBackColor propriedade.

Exemplos

O exemplo de código seguinte define o BackColor e ForeColor dos controlos para as cores padrão do sistema. O código chama-se recursivamente se o controlo tiver algum controlo filho. Este exemplo de código exige que tenhas um Form com pelo menos um controlo filho; no entanto, um controlo de contentor filho, como um Panel ou GroupBox, com os seus próprios controlos filhos, 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

Observações

A propriedade BackColor não suporta cores transparentes a menos que o valor SupportsTransparentBackColor de System.Windows.Forms.ControlStyles esteja definido para true.

A BackColor propriedade é uma propriedade ambiente. Uma propriedade ambiente é uma propriedade de controlo que, se não for definida, é recuperada do controlo principal. Por exemplo, um Button terá o mesmo BackColor que o seu pai Form por defeito. Para mais informações sobre propriedades ambientais, consulte a AmbientProperties classe ou a Control visão geral da classe.

Notas para Herdeiros

Ao sobrescrever a BackColor propriedade numa classe derivada, use a propriedade da BackColor classe base para estender a implementação base. Caso contrário, deve fornecer toda a implementação. Não é obrigado a anular ambos os get acessórios da BackColor propriedadeset; só pode anular um, se necessário.

Ver também

• AmbientProperties
• BackColorChanged