IXRTextElement::SetForeground (Compact 2013)
This method sets the brush that paints the text in this text element.
virtual HRESULT STDMETHODCALLTYPE SetForeground( __in IXRBrush* pForeground ) = 0;
[in] Pointer to an object derived from IXRBrush that paints the text in the text element.
Returns an HRESULT that indicates success or failure.
Returns XR_E_INVALID_OBJECT if pForeground is not a XAML for Windows Embedded object.
The value of pForeground specifies the brush for the displayed text. A brush can represent a solid color, a linear or radial gradient, or an image.
When you animate the foreground text in Microsoft Silverlight 3 XAML, you must use indirect targeting syntax. For example, to animate the color of a SolidColorBrush control that is the foreground of a TextBlock control, you could use the following:
<ColorAnimation ... Storyboard.TargetProperty="(TextBlock.Foreground).(SolidColorBrush.Color)" />.
For more information about how to set the foreground brush in Silverlight 3 XAML, see the Microsoft Silverlight 3 documentation.
To use a specific interface pointer type, you can use the helper template version of this method that XAML for Windows Embedded provides. When you supply a derived type, this version automatically supplies a type-safe method that implicitly converts the returned type from a generic interface, so you do not have to explicitly call QueryInterface to convert the generic interface into the required object type.
.NET Framework Equivalent