Expand Minimize

Control.Foreground property

Applies to Windows and Windows Phone

Gets or sets a brush that describes the foreground color.

Syntax


public:
property Brush^ Foreground { 
   Brush^ get();
   void set (Brush^ value);
}


<control Foreground="{StaticResource resourceName}"/>



<control Foreground="colorString"/>



<control>
  <control.Foreground>singleBrush</control.Foreground>
</control>


XAML Values

resourceName

The resource name (x:Key value) of an existing XAML resource that defines a brush. This is the recommended way to specify Brush values in XAML if you have any intention of using the same colors or brushes in more than one part of your UI. See Remarks in Brush or ResourceDictionary and XAML resource references.

colorString

The Color for a SolidColorBrush expressed as an attribute string. This can be a named color, an RGB value, or an ScRGB value. RGB or ScRGB may also specify alpha information. See the "XAML Values" section in Color.

singleBrush

Within opening and closing property elements, exactly one object element for an object that derives from Brush. This is typically one of the following classes: LinearGradientBrush, ImageBrush, SolidColorBrush.

Property value

Type: Brush

The brush that paints the foreground of the control. The default value is a SolidColorBrush with color of Black.

Remarks

Each control might apply this property differently based on its visual template. This property only affects a control whose template uses the Foreground property as a parameter. On other controls, this property has no effect. Typically, a ContentControl derived control uses a TemplateBinding to bind its Foreground value to the Foreground of a ContentPresenter within the control template. The same color/brush might also be used for values of other decorative elements in the template (glyphs, icons, control surfaces) or to composite part properties such as the individual ComboBox elements of the TimePicker control. For more info about visual templates and control templating, see reference page for the Template property, or Quickstart: Control templates.

Requirements

Minimum supported client

Windows 8

Minimum supported server

Windows Server 2012

Minimum supported phone

Windows Phone 8.1 [Windows Runtime apps only]

Namespace

Windows.UI.Xaml.Controls
Windows::UI::Xaml::Controls [C++]

Metadata

Windows.winmd

See also

Control
Quickstart: Using brushes

 

 

Show:
© 2014 Microsoft