IconElement.Foreground 属性

定义

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

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"/>

属性值

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

示例

此示例演示了一个 AppBarButton,该 AppBarButton 使用 SymbolIcon ,其前景设置为“Green”。

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

注解

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

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

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

适用于

另请参阅