Control.Foreground Property (System.Windows.Controls)

.NET Framework Class Library

Control..::.Foreground Property

Gets or sets a brush that describes the foreground color. This is a dependency property.

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

Syntax

Visual Basic (Declaration)

<BindableAttribute(True)> _
Public Property Foreground As Brush

Visual Basic (Usage)

Dim instance As Control
Dim value As Brush

value = instance.Foreground

instance.Foreground = value

[BindableAttribute(true)]
public Brush Foreground { get; set; }

Visual C++

[BindableAttribute(true)]
public:
property Brush^ Foreground {
    Brush^ get ();
    void set (Brush^ value);
}

JScript

public function get Foreground () : Brush
public function set Foreground (value : Brush)

XAML

For XAML information, see the Brush type.

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.

Dependency Property Information

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

Remarks

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

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>

Visual Basic

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

void ChangeForeground(object sender, RoutedEventArgs e)
{
    if (btn1.Foreground == Brushes.Green)
    {
        btn1.Foreground = Brushes.Black;
        btn1.Content = "Foreground";
    }
    else
    {
        btn1.Foreground = Brushes.Green;
        btn1.Content = "Control foreground(text) changes from black to green.";
    }
}

Platforms

Windows 7, Windows Vista, Windows XP SP2, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Version Information

.NET Framework

Supported in: 3.5, 3.0

Reference

Control Class

Control Members

System.Windows.Controls Namespace

Other Resources

Control Library