TextBlock.Foreground Propriedade

Definição

Namespace:

Microsoft.UI.Xaml.Controls

Obtém ou define o Brush a ser aplicado ao conteúdo de texto do 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>

Valor da propriedade

Brush

O pincel usado para aplicar ao conteúdo do texto. O padrão é um pincel nulo de uma perspectiva de código puro, mas os estilos de texto padrão definem isso como Preto (para tema Claro ) ou Branco (para tema Escuro ) para um elemento TextBlock na interface do usuário.

Exemplos

O exemplo XAML a seguir mostra como definir a propriedade Foreground como uma cor sólida usando um valor de atributo definido embutido "Maroon". O analisador XAML usa esse valor "Maroon" para se referir à cor nomeada Colors.Maroon e para criar a instância SolidColorBrush que fornece o valor de runtime.

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

Comentários

TextBlock não é um controle, portanto, você não usa modelos para alterar sua aparência. Em vez disso, você pode usar estilos. É mais comum (e uma prática melhor) usar estilos nomeados para a aparência textblock do que definir atributos embutidos para cada instância textblock , especialmente se você estiver usando valores comuns em muitos elementos. Para obter mais informações sobre estilos, consulte Estilos XAML.

A aparência padrão dos estilos de texto e texto depende muito do tema ativo e de outras configurações. O tema e vários estilos e comportamentos que estão usando configurações padrão do sistema ou preferências do usuário são a origem da aparência em tempo de execução efetiva da cor de primeiro plano textBlock do texto, bem como outras características de texto. Você pode alterar esses padrões alterando os valores de propriedade ou aplicando um estilo diferente a instâncias específicas do TextBlock . Você pode alterar o valor de primeiro plano para todo o texto padrão substituindo o recurso chamado DefaultTextForegroundThemeBrush em App.xaml.

Confira também

• Bloco de texto
• Pincéis em XAML