Control.BackColor Właściwość

Definicja

Pobiera lub ustawia kolor tła formantu.Gets or sets the background color for the control.

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

ColorReprezentujący kolor tła kontrolki.A Color that represents the background color of the control. Wartością domyślną jest wartość DefaultBackColor właściwości.The default is the value of the DefaultBackColor property.

Przykłady

Poniższy przykład kodu ustawia BackColor ForeColor domyślne kolory systemowe i kontrolek.The following code example sets the BackColor and ForeColor of the controls to the default system colors. Kod cyklicznie wywołuje siebie, Jeśli kontrolka ma jakiekolwiek kontrolki podrzędne.The code recursively calls itself if the control has any child controls. Ten przykład kodu wymaga, aby miało Form co najmniej jedną kontrolkę podrzędną; jednak kontrolka podrzędnego kontenera, taka jak Panel lub GroupBox , z własnymi kontrolkami podrzędnymi lepiej ilustruje rekursję.This code example requires that you have a Form with at least one child control; however, a child container control, like a Panel or GroupBox, with its own child control(s) would better demonstrate the recursion.

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

BackColorWłaściwość nie obsługuje przezroczystych kolorów, chyba że SupportsTransparentBackColor wartość System.Windows.Forms.ControlStyles jest ustawiona na true .The BackColor property does not support transparent colors unless the SupportsTransparentBackColor value of System.Windows.Forms.ControlStyles is set to true.

BackColorWłaściwość jest właściwością otoczenia.The BackColor property is an ambient property. Właściwość otoczenia jest właściwością kontrolki, która jeśli nie jest ustawiona, zostanie pobrana z kontrolki nadrzędnej.An ambient property is a control property that, if not set, is retrieved from the parent control. Na przykład wartość a Button będzie taka sama BackColor jak jej element nadrzędny Form domyślnie.For example, a Button will have the same BackColor as its parent Form by default. Aby uzyskać więcej informacji o właściwościach otoczenia, zobacz AmbientProperties klasy lub Control Przegląd klas.For more information about ambient properties, see the AmbientProperties class or the Control class overview.

Uwagi dotyczące dziedziczenia

Podczas zastępowania BackColor właściwości w klasie pochodnej należy użyć właściwości klasy bazowej, BackColor Aby zwiększyć podstawową implementację.When overriding the BackColor property in a derived class, use the base class's BackColor property to extend the base implementation. W przeciwnym razie musisz podać wszystkie implementacje.Otherwise, you must provide all the implementation. Nie jest wymagane przesłonięcie obu get metod i set dostępu do BackColor właściwości; w razie potrzeby można przesłonić tylko jeden.You are not required to override both the get and set accessors of the BackColor property; you can override only one if needed.

Dotyczy

Zobacz też