Control.ForeColor Właściwość

Definicja

Pobiera lub ustawia kolor pierwszego planu kontrolki.

public:
 virtual property System::Drawing::Color ForeColor { System::Drawing::Color get(); void set(System::Drawing::Color value); };
public virtual System.Drawing.Color ForeColor { get; set; }
member this.ForeColor : System.Drawing.Color with get, set
Public Overridable Property ForeColor As Color

Wartość właściwości

Color

Pierwszy plan Color kontrolki. Wartość domyślna to wartość DefaultForeColor 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 posiadania Form 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

Obiekt ForeColor 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 obiekt Button będzie domyślnie taki sam BackColor jak jego element nadrzędny Form . Aby uzyskać więcej informacji na temat właściwości otoczenia, zobacz AmbientProperties omówienie klasy lub Control klasy.

Uwagi dotyczące dziedziczenia

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

Dotyczy

Zobacz też