Freigeben über

MonthCalendar.ForeColor Eigenschaft

  • Referenz

Definition

Namespace:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Ruft die Vordergrundfarbe des Steuerelements ab oder legt diese fest.

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

Eigenschaftswert

Color

Die Vordergrund-Color des Steuerelements. Der Standardwert ist der Wert der DefaultForeColor-Eigenschaft.

Beispiele

Im folgenden Codebeispiel werden die BackColor Steuerelemente ForeColor auf die Standardsystemfarben festgelegt. Der Code ruft sich rekursiv auf, wenn das Steuerelement über untergeordnete Steuerelemente verfügt. Dieses Codebeispiel erfordert, dass Sie über mindestens ein Form untergeordnetes Steuerelement verfügen. Ein untergeordnetes Containersteuerelement wie ein Panel oder GroupBox, mit eigenen untergeordneten Steuerelementen, würde die Rekursion jedoch besser veranschaulichen.

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

Hinweise

Die ForeColor Eigenschaft ist eine Umgebungseigenschaft. Eine Umgebungseigenschaft ist eine Steuerelementeigenschaft, die, wenn nicht festgelegt, aus dem übergeordneten Steuerelement abgerufen wird. Beispielsweise wird ein Button Element standardmäßig mit dem übergeordneten Form Element identisch BackColor sein. Weitere Informationen zu Umgebungseigenschaften finden Sie in der AmbientProperties Klasse oder in der Control Klassenübersicht.

Ab Windows Vista und je nach Design ändert das Festlegen dieser Eigenschaft möglicherweise nicht das Aussehen des Kalenders. Wenn beispielsweise Windows auf die Verwendung des Aero-Designs festgelegt ist, hat die Einstellung dieser Eigenschaft keine Auswirkung. Dies liegt daran, dass eine aktualisierte Version des Kalenders mit einer Darstellung gerendert wird, die zur Laufzeit vom aktuellen Betriebssystemdesign abgeleitet wird. Wenn Sie diese Eigenschaft verwenden und die frühere Version des Kalenders aktivieren möchten, können Sie visuelle Formatvorlagen für Ihre Anwendung deaktivieren. Das Deaktivieren visueller Formatvorlagen wirkt sich möglicherweise auf das Aussehen und Verhalten anderer Steuerelemente in Ihrer Anwendung aus. Um visuelle Formatvorlagen in Visual Basic zu deaktivieren, öffnen Sie den Project Designer, und deaktivieren Sie das Kontrollkästchen "VISUELLE XP-Formatvorlagen aktivieren". Um visuelle Formatvorlagen in C# zu deaktivieren, öffnen Sie "Program.cs" und "Kommentar" Application.EnableVisualStyles();.

Hinweise für Vererber

Verwenden Sie beim Überschreiben der Eigenschaft in einer abgeleiteten Klasse die ForeColor Eigenschaft der Basisklasse ForeColor , um die Basisimplementierung zu erweitern. Andernfalls müssen Sie alle Implementierungen bereitstellen. Sie sind nicht erforderlich, um sowohl die get Als set auch die Zugriffsoren der ForeColor Eigenschaft außer Kraft zu setzen. Sie können nur eine außer Kraft setzen, wenn sie erforderlich ist.

Gilt für

Siehe auch