Control.BackColor Właściwość

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Windows.Forms
Zestaw:
System.Windows.Forms.dll

Pobiera lub ustawia kolor tła kontrolki.

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

Wartość właściwości

Color

Element Color reprezentujący kolor tła kontrolki. Wartość domyślna to wartość DefaultBackColor właściwości.

Przykłady

Poniższy przykład kodu ustawia kontrolki BackColor i ForeColor na domyślne kolory systemowe. Kod cyklicznie wywołuje się, jeśli kontrolka ma jakiekolwiek kontrolki podrzędne. Ten przykład kodu wymaga Form posiadania co najmniej jednej kontrolki podrzędnej. Jednak kontrolka kontenera podrzędnego, taka jak lub Panel GroupBox, z własnymi kontrolkami podrzędnymi lepiej demonstruje rekursję.

   // 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

Uwagi

Właściwość BackColor nie obsługuje kolorów przezroczystych, chyba że wartość System.Windows.Forms.ControlStyles jest ustawiona SupportsTransparentBackColor na true.

Właściwość BackColor jest właściwością otoczenia. Właściwość otoczenia jest właściwością kontrolki, która, jeśli nie jest ustawiona, jest pobierana z kontrolki nadrzędnej. Na przykład element Button będzie miał taki sam jak BackColor jego element nadrzędny Form domyślnie. Aby uzyskać więcej informacji na temat właściwości otoczenia, zobacz klasę AmbientProperties Control lub omówienie klasy.

Uwagi dotyczące dziedziczenia

Podczas zastępowania BackColor właściwości w klasie pochodnej użyj właściwości klasy BackColor bazowej, aby rozszerzyć implementację podstawową. W przeciwnym razie należy podać całą implementację. Nie jest wymagane zastąpienie właściwości get i set metod dostępu BackColor . W razie potrzeby można zastąpić tylko jedno.

Dotyczy

Zobacz też