TextElement.Foreground Свойство

Определение

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

System.Windows.Documents

Сборка:

PresentationFramework.dll

Возвращает или задает кисть, которая применяется к содержимому элемента.

public:
 property System::Windows::Media::Brush ^ Foreground { System::Windows::Media::Brush ^ get(); void set(System::Windows::Media::Brush ^ value); };

public System.Windows.Media.Brush Foreground { get; set; }

member this.Foreground : System.Windows.Media.Brush with get, set

Public Property Foreground As Brush

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

Brush

Кисть, применяемая к текстовому содержимому. Значение по умолчанию — Black.

Примеры

В следующем примере показано, как задать атрибут Foreground, используя элемент Paragraph в качестве образца.

<FlowDocumentReader>
  <FlowDocument>
    <Paragraph
      Background="Bisque"
      Foreground="DarkGreen"
      Padding="4"
    >
      <Run>
        This text has a foreground color of dark green, and a background color of bisque.
      </Run>
    </Paragraph>
  </FlowDocument>
</FlowDocumentReader>

На следующем рисунке показано, как отрисовывается предыдущий пример.

В следующем примере показано, как программным образом присвоить значение свойству Foreground.

Run run = new Run(
    "This text has a foreground color of dark green, and a background color of bisque.");
Paragraph par = new Paragraph(run);

par.Background = Brushes.Bisque;
par.Foreground = Brushes.DarkGreen;

Dim run As New Run("This text has a foreground color of dark green, and a background color of bisque.")
Dim par As New Paragraph(run)

par.Background = Brushes.Bisque
par.Foreground = Brushes.DarkGreen

Комментарии

Таблицу образцов с доступными предопределенными цветами кисти см. в разделе Brushes.

Это свойство зависимостей также имеет присоединенное свойство. В XAML используется <object TextElement.Foreground="value".../>, где object — это элемент объекта (обычно элемент потока), содержащийся в TextElement, а value — это строка, разрешающаяся Brush в значение реализации. В коде использование присоединенного свойства поддерживается методами GetForeground и SetForeground . Присоединенное свойство используется не так часто, так как большинство элементов, которые могут содержаться в TextElement , поддерживают аналогичное неприсоединяемое Foreground свойство, которое узел содержимого использует для отрисовки.

Сведения о свойстве зависимостей

Поле идентификатора	ForegroundProperty
Для свойств метаданных задано значение true	AffectsRender, Inherits, SubPropertiesDoNotAffectRender

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

• Background