Partilhar via


MonthCalendar.BackColor Propriedade

Definição

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 override System.Drawing.Color BackColor { get; set; }
member this.BackColor : System.Drawing.Color with get, set
Public Overrides Property BackColor As Color

Valor da propriedade

Color

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 para as cores padrão do sistema. O código se chamará 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.

Começando com Windows Vista e dependendo do tema, definir essa propriedade pode não alterar a aparência do calendário. Por exemplo, se Windows estiver definida para usar o tema Aero, definir essa propriedade não terá efeito. Isso ocorre porque uma versão atualizada do calendário é renderizada com uma aparência derivada no tempo de execução do tema atual do sistema operacional. Se você quiser usar essa propriedade e habilitar a versão anterior do calendário, poderá desabilitar estilos visuais para seu aplicativo. Desabilitar os estilos visuais pode afetar a aparência e o comportamento de outros controles no seu aplicativo. Para desabilitar estilos visuais em Visual Basic, abra o Designer de Project e desmarque a caixa de seleção Habilitar estilos visuais XP. Para desabilitar estilos visuais em C#, abra Program.cs e comente Application.EnableVisualStyles();.

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 é obrigado a substituir os acessadores e set os get acessadores da BackColor propriedade; você pode substituir apenas um, se necessário.

Aplica-se a

Confira também