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:
property Brush^ Foreground {
	Brush^ get ();
	void set (Brush^ value);
}

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 attached property 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.

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


<FlowDocumentReader>
  <FlowDocument>
    <Paragraph
      Background="Bisque"
      Foreground="DarkGreen"
      Padding="4"
    >
      <Run>
        This text has a foreground color of dark green, and a background color of bisque.
      </Run>
    </Paragraph>
  </FlowDocument>
</FlowDocumentReader>


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.

No code example is currently available or this language may not be supported.

.NET Framework

Supported in: 4, 3.5, 3.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
Was this page helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft