TextBlock.Foreground Propriété

Définition

Espace de noms:

Microsoft.UI.Xaml.Controls

Obtient ou définit le pinceau à appliquer au contenu texte du TextBlock.

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>

Valeur de propriété

Brush

Pinceau utilisé pour appliquer au contenu du texte. La valeur par défaut est un pinceau Null du point de vue du code pur, mais les styles de texte par défaut le définissent sur Noir (pour le thème Clair ) ou Blanc (pour le thème Foncé ) pour un élément TextBlock dans l’interface utilisateur.

Exemples

L’exemple XAML suivant montre comment définir la propriété Foreground sur une couleur unie à l’aide d’une valeur d’attribut définie en ligne « Maroon ». L’analyseur XAML utilise cette valeur « Maroon » pour faire référence à la couleur nommée Colors.Maroon et pour créer le instance SolidColorBrush qui fournit la valeur runtime.

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

Remarques

TextBlock n’est pas un contrôle, vous n’utilisez donc pas de modèles pour modifier son apparence. Au lieu de cela, vous pouvez utiliser des styles. Il est plus courant (et une meilleure pratique) d’utiliser des styles nommés pour l’apparence de TextBlock que de définir des attributs inline pour chaque instance TextBlock, en particulier si vous utilisez des valeurs communes dans de nombreux éléments. Pour plus d’informations sur les styles, consultez Styles XAML.

L’apparence par défaut du texte et des styles de texte dépend fortement du thème actif et d’autres paramètres. Le thème et les différents styles et comportements qui utilisent les paramètres système par défaut ou les préférences utilisateur sont la source de l’apparence d’exécution effective de la couleur de premier plan TextBlock du texte, ainsi que d’autres caractéristiques du texte. Vous pouvez modifier ces valeurs par défaut en modifiant les valeurs de propriété ou en appliquant un style différent à des instances TextBlock spécifiques. Vous pouvez modifier la valeur de premier plan pour tout le texte par défaut en remplaçant la ressource nommée DefaultTextForegroundThemeBrush dans App.xaml.

Voir aussi

• Bloc de texte
• Pinceaux XAML