IconElement.Foreground Eigenschaft

Referenz

Definition

Namespace:: Microsoft.UI.Xaml.Controls

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Bearbeiten

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

Brush

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 von einer Standardsystemressource zur Laufzeit festgelegt, die an das aktive Design und andere Einstellungen gebunden ist.

Beispiele

In diesem Beispiel wird ein AppBarButton-Objekt gezeigt, das 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 Foreground-Eigenschaft auf dem AppBarButton oder auf einem von IconElement abgeleiteten Symbol festlegen. Wenn Sie den Vordergrund im AppBarButton festlegen, wird er nur auf den standardmäßigen visuellen Zustand angewendet. Sie 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 abgeleiteten Symbol IconElement 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 . Jedes nicht transparente Pixel im Quellbild wird durch die Vordergrundfarbe ersetzt.

Gilt für:

Freigeben über