Control.Foreground 属性

定义

获取或设置一个用于描述前景色的画笔。

适用于 UWP 的等效 WinUI 2 API:Windows 应用 SDK中 WinUI 的 Microsoft.UI.Xaml.Controls.Control.Foreground (,请参阅Windows 应用 SDK命名空间) 。

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

void Foreground(Brush value);
public Brush Foreground { get; set; }
var brush = control.foreground;
control.foreground = brush;
Public Property Foreground As Brush
<control Foreground="{StaticResource resourceName}"/>
- or -
<control Foreground="colorString"/>
- or -
<control>
  <control.Foreground>singleBrush</control.Foreground>
</control>

属性值

Brush

用于绘制控件的前景的画笔。 默认值为SolidColorBrush颜色 。Black

注解

每个控件都可以根据其视觉模板以不同的方式应用此属性。 此属性仅影响模板使用 Foreground 属性作为参数的控件。 在其他控件上,此属性不起作用。 通常,ContentControl派生控件使用 {TemplateBinding} 标记扩展将其 Foreground 值绑定到控件模板内的某个ContentPresenterForeground。 同一颜色/画笔还可用于模板中其他装饰元素的值 (字形、图标、控件图面) 或复合部件属性(如控件的各个ComboBoxTimePicker元素)。 有关视觉模板和控件模板化的详细信息,请参阅属性的Template样式控件或参考页。

从 Windows 10 版本 1607 (Windows 软件开发工具包 (SDK) 版本 10.0.14393.0) 开始,generic.xaml 包含可用于修改不同视觉状态中的控件颜色的资源,而无需修改控件模板。 在面向此软件开发工具包的应用中, (SDK) 或更高版本,修改这些资源是设置属性的首选,例如 Background,前台和 BorderBrush。 有关详细信息,请参阅样式控件文章的轻量级样式部分。

适用于

另请参阅