TextBlock.Foreground Eigenschaft

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 ein NULL-Pinsel aus einer reinen Codeperspektive, aber die Standardtextformatvorlagen legen diese auf Schwarz (für helles Design) oder Weiß (für das dunkle Design) für ein TextBlock-Element in der Benutzeroberfläche fest.

Beispiele

Das folgende XAML-Beispiel zeigt, wie die Foreground-Eigenschaft mit einem inline definierten Attributwert "Maroon" auf eine Volltonfarbe festgelegt wird. Der XAML-Parser verwendet diesen "Maroon"-Wert, um auf die benannte Farbe Colors.Maroon zu verweisen, und um die SolidColorBrush-Instanz zu erstellen, die den Laufzeitwert bereitstellt.

<TextBlock
  FontSize="32"
  FontWeight="Bold"
  Foreground="Maroon">
  Maroon
</TextBlock>

Hinweise

TextBlock ist kein Steuerelement, sodass Sie keine Vorlagen verwenden, um die 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 jede TextBlock-Instanz festzulegen, insbesondere wenn Sie allgemeine Werte in vielen Elementen verwenden. Weitere Informationen zu Formatvorlagen finden Sie unter XAML-Formatvorlagen.

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 von Text sowie andere 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 alle Standardtexte ändern, indem Sie die Ressource mit dem Namen DefaultTextForegroundThemeBrush in "App.xaml" überschreiben.

Weitere Informationen

• Textblock
• XAML-Pinsel