IconElement.Foreground 属性

定义

命名空间:

Microsoft.UI.Xaml.Controls

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

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

Brush Foreground();

void Foreground(Brush value);

public Brush Foreground { get; set; }

var brush = iconElement.foreground;
iconElement.foreground = brush;

Public Property Foreground As Brush

<icon Foreground="{StaticResource resourceName}"/>
- or -
<icon Foreground="colorString"/>

属性值

Brush

用于绘制控件的前景的画笔。 默认值为 null， (一个 null 画笔) 该画笔的计算结果为 透明 呈现。 但是，此值通常由默认系统资源在运行时设置，该资源与活动主题和其他设置相关联。

示例

此示例演示了一个 AppBarButton ，它使用 一个 SymbolIcon ，其前台设置为“Green”。

<AppBarButton Label="Accept">
    <AppBarButton.Icon>
        <SymbolIcon Symbol="Accept" Foreground="Green"/>
    </AppBarButton.Icon>
</AppBarButton>

注解

可以在 AppBarButton 或 IconElement 派生图标上设置 Foreground 属性。 如果在 AppBarButton 上设置 Foreground，则它仅应用于默认视觉状态。 它不适用于 AppBarButton 模板中定义的其他视觉状态，例如 MouseOver。 如果在 IconElement 派生图标上设置前景，则颜色将应用于所有视觉状态。

Foreground 值的唯一有效 Brush 类型是 SolidColorBrush。 如果尝试使用未声明纯色的画笔，该值在运行时将被忽略，并替换为白色或黑色的 SolidColorBrush ，具体取决于当前主题。

前景替换 BitmapIcon.UriSource 源文件中的颜色信息。 源图像中的任何非透明像素将替换为前景色。

另请参阅

• UriSource
• SymbolIcon
• 添加应用栏
• XAML 画笔