Control.Foreground Property

.NET Framework (current version)

Gets or sets a brush that describes the foreground color.

Namespace: System.Windows.Controls
Assembly: PresentationFramework (in PresentationFramework.dll)

Syntax

<BindableAttribute(True)>
Public Property Foreground As Brush

Property Value

Type: System.Windows.Media.Brush

The brush that paints the foreground of the control. The default value is the system dialog font color.

Remarks

This property only affects a control whose template uses the Foreground property as a parameter. On other controls, this property has no impact.

Dependency Property Information

Identifier field	ForegroundProperty
Metadata properties set to true	AffectsRender, SubPropertiesDoNotAffectRender, Inherits

Examples

The following example shows how to set the font style property of a control.

XAML

<Button Name="btn1" Foreground="Black" 
        Click="ChangeForeground">
  Foreground
</Button>

Private Sub ChangeForeground(ByVal Sender As Object, ByVal e As RoutedEventArgs)

    If (Equals(btn1.Foreground, Brushes.Green)) Then

        btn1.Foreground = Brushes.Black
        btn1.Content = "Foreground"

    Else

        btn1.Foreground = Brushes.Green
        btn1.Content = "Control foreground(text) changes from black to green."
    End If
End Sub

Version Information

.NET Framework
Available since 3.0
Silverlight
Available since 2.0
Windows Phone Silverlight
Available since 7.0