Langage

TextBlock.Foreground Propriété

Définition

Obtient ou définit le pinceau à appliquer au contenu du 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é

Pinceau utilisé pour s’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 définissent ceci sur Noir (pour le thème Clair ) ou Blanc (pour le thème sombre ) pour un élément TextBlock dans l’interface utilisateur.

Exemples

L’exemple XAML suivant montre comment définir la propriété de premier plan 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 l’instance SolidColorBrush qui fournit la valeur d’exécution.

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

Remarques

TextBlock n’est pas un contrôle de sorte que vous n’utilisez 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 textBlock qu’il consiste à 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 effective du runtime de la couleur de premier plan textBlock ainsi que d’autres caractéristiques de 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.

S’applique à

Voir aussi