Foreground Property

TextElement.Foreground Property


Gets or sets the Brush to apply to the content of the element.

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

public Brush Foreground { get; set; }

Property Value

Type: System.Windows.Media.Brush

The brush used to apply to the text contents. The default is Brushes.Black.

For a table of swatches that shows the available predefined brush colors, see Brushes.

This dependency property also has an usage. In XAML, the usage is <object TextElement.Foreground="value".../>, where object is an object element (typically a flow element) contained within a TextElement, and value is a string that resolves to a Brush implementation value. In code, the attached property usage is supported by the GetForeground and SetForeground methods. The attached property usage is not common, because most elements that can be contained in a TextElement support an analogous nonattached Foreground property, which the content host uses for rendering.GTMT

The following example shows how to set the Foreground attribute, using Paragraph as the example element.

The following figure shows how the preceding example renders.

Screenshot: Foreground of green, background bisque

The following example shows how to set the Foreground property programmatically.

.NET Framework
Available since 3.0
Available since 4.0
Windows Phone Silverlight
Available since 7.1
Return to top
© 2015 Microsoft