TextBlock.Foreground Eigenschaft

  • Referenz

Definition

Namespace:
Windows.UI.Xaml.Controls
Bearbeiten

Ruft den Pinsel ab, der auf den Textinhalt von TextBlock angewendet werden soll, 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 = 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

Brush

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.

Gilt für:

Weitere Informationen