Freigeben über


IconElement.Foreground Eigenschaft

Definition

Ruft einen Pinsel ab, der die Vordergrundfarbe beschreibt, oder legt diesen fest.

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

Eigenschaftswert

Der Pinsel, der den Vordergrund des Steuerelements zeichnet. Der Standardwert ist NULL( ein NULL-Pinsel), der für das Rendern als Transparent ausgewertet wird. Dieser Wert wird jedoch in der Regel durch eine Standardsystemressource zur Laufzeit festgelegt, die an das aktive Design und andere Einstellungen gebunden ist.

Beispiele

Dieses Beispiel zeigt einen AppBarButton , der ein SymbolIcon verwendet, dessen Vordergrund auf "Grün" festgelegt ist.

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

Hinweise

Sie können die Vordergrundeigenschaft im AppBarButton oder auf einem von IconElement abgeleiteten Symbol festlegen. Wenn Sie den Vordergrund auf appBarButton festlegen, wird er nur auf den standardmäßigen visuellen Zustand angewendet. Es wird nicht auf die anderen visuellen Zustände angewendet, die in der AppBarButton-Vorlage definiert sind, z. B MouseOver. . Wenn Sie den Vordergrund auf dem von IconElement abgeleiteten Symbol festlegen, wird die Farbe auf alle visuellen Zustände angewendet.

Der einzige gültige Pinseltyp für den Vordergrundwert ist SolidColorBrush. Wenn Sie versuchen, einen Pinsel zu verwenden, der keine Volltonfarbe deklariert, wird der Wert zur Laufzeit ignoriert und je nach aktuellem Design durch einen SolidColorBrush ersetzt, der weiß oder schwarz ist.

Der Vordergrund ersetzt die Farbinformationen aus einer BitmapIcon.UriSource-Quelldatei . Alle nicht transparenten Pixel im Quellbild werden durch die Vordergrundfarbe ersetzt.

Gilt für:

Weitere Informationen