TextBlock.Foreground Свойство

Определение

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

Microsoft.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

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

Примеры

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

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

Комментарии

TextBlock не является элементом управления, поэтому вы не используете шаблоны для изменения его внешнего вида. Вместо этого можно использовать стили. Чаще (и лучше) использовать именованные стили для внешнего вида TextBlock , чем задавать встроенные атрибуты для каждого экземпляра TextBlock , особенно если используются общие значения во многих элементах. Дополнительные сведения о стилях см. в статье Стили XAML.

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

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

• Блок текста
• Кисти XAML