TextBlock.Foreground Свойство

Определение

Пространство имен:

Windows.UI.Xaml.Controls

Возвращает или задает кисть , применяемую к текстовому содержимому элемента 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>

Значение свойства

Brush

Кисть, используемая для применения к текстовому содержимому. По умолчанию используется пустая кисть с точки зрения чистого кода, но в текстовых стилях по умолчанию задано значение Черный (для светлой темы) или Белый (для темной темы) для элемента TextBlock в пользовательском интерфейсе.

Примеры

В следующем примере XAML показано, как задать для свойства Foreground сплошной цвет с помощью встроенного значения атрибута Maroon. Средство синтаксического анализа XAML использует это значение Maroon для ссылки на именованный color Colors.Maroon и для создания экземпляра SolidColorBrush , предоставляющего значение среды выполнения.

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

Комментарии

TextBlock не является элементом управления, поэтому вы не используете шаблоны для изменения его внешнего вида. Вместо этого можно использовать стили. Использование именованных стилей для внешнего вида TextBlock чаще , чем установка встроенных атрибутов для каждого экземпляра TextBlock , особенно при использовании общих значений во многих элементах. Дополнительные сведения о стилях см. в статье Краткое руководство. Стилизация элементов управления.

Внешний вид текста и стилей текста по умолчанию в значительной степени зависит от активной темы и других параметров. Тема и различные стили и поведения, использующие системные параметры по умолчанию или пользовательские настройки, являются источником эффективного внешнего вида textBlock переднего плана TextBlock , а также других характеристик текста. Эти значения по умолчанию можно изменить, изменив значения свойств или применив другой стиль к определенным экземплярам TextBlock . Вы можете изменить значение переднего плана для всего текста по умолчанию, переопределив ресурс с именем DefaultTextForegroundThemeBrush в Файле App.xaml.

См. также раздел

• Краткое руководство. Отображение текста
• Использование кистей