TextBlock.Foreground Eigenschaft
Definition
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.
public:
property Brush ^ Foreground { Brush ^ get(); void set(Brush ^ value); };Brush Foreground();
void Foreground(Brush value);public Brush Foreground { get; set; }var brush = textBlock.foreground;
textBlock.foreground = brush;Public Property Foreground As Brush<TextBlock Foreground="{StaticResource resourceName}"/>
- or -
<TextBlock Foreground="colorString"/>
- or -
<TextBlock>
<TextBlock.Foreground>singleBrush</TextBlock.Foreground>
</TextBlock>
Eigenschaftswert
Der Pinsel, der zum Anwenden auf den Textinhalt verwendet wird. Der Standardwert ist aus der Perspektive des reinen Codes ein NULL-Pinsel, aber in den Standardtextformaten wird dies für ein TextBlock-Element in der Benutzeroberfläche auf Schwarz (für Lichtdesign) oder Weiß (für dunkles Design) festgelegt.
Beispiele
Im folgenden XAML-Beispiel wird gezeigt, wie die Vordergrundeigenschaft mithilfe des inline definierten Attributwerts "Maroon" auf eine Vollfarbe festgelegt wird. Der XAML-Parser verwendet diesen "Maroon"-Wert, um auf die benannte Farbe Colors.Maroon zu verweisen und die SolidColorBrush-instance zu erstellen, die den Laufzeitwert bereitstellt.
<TextBlock
FontSize="32"
FontWeight="Bold"
Foreground="Maroon">
Maroon
</TextBlock>
Hinweise
TextBlock ist kein Steuerelement, daher verwenden Sie keine Vorlagen, um dessen Darstellung zu ändern. Stattdessen können Sie Formatvorlagen verwenden. Es ist häufiger (und eine bessere Methode), benannte Formatvorlagen für die TextBlock-Darstellung zu verwenden, als Inlineattribute für jeden TextBlock-instance festzulegen, insbesondere wenn Sie allgemeine Werte in vielen Elementen verwenden. Weitere Informationen zu Formatvorlagen finden Sie unter Schnellstart: Formatieren von Steuerelementen.
Die Standarddarstellung von Text- und Textformatvorlagen hängt stark vom aktiven Design und anderen Einstellungen ab. Das Design und verschiedene Stile und Verhaltensweisen, die Standardsystemeinstellungen oder Benutzereinstellungen verwenden, sind die Quelle der effektiven Laufzeitdarstellung der TextBlock-Vordergrundfarbe des Texts sowie anderer Textmerkmale. Sie können diese Standardwerte ändern, indem Sie die Eigenschaftswerte ändern oder eine andere Formatvorlage auf bestimmte TextBlock-Instanzen anwenden. Sie können den Vordergrundwert für den gesamten Standardtext ändern, indem Sie die Ressource DefaultTextForegroundThemeBrush in App.xaml überschreiben.