TextElement.Foreground Właściwość

Definicja

Pobiera lub ustawia szczotkę w celu zastosowania do zawartości elementu.

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

Wartość właściwości

Brush

Szczotka używana do zastosowania do zawartości tekstu. Wartość domyślna to Black.

Przykłady

W poniższym przykładzie pokazano, jak ustawić Foreground atrybut przy użyciu Paragraph elementu przykładowego.

XAML
<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>

Na poniższej ilustracji przedstawiono sposób renderowania poprzedniego przykładu.

Zrzut ekranu: Pierwszy plan zielony, bisque tła

W poniższym przykładzie pokazano, jak programowo ustawić Foreground właściwość.

C#
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;

Uwagi

Aby zapoznać się z tabelą próbek, która pokazuje dostępne wstępnie zdefiniowane kolory pędzla, zobacz Brushes.

Ta właściwość zależności ma również dołączone użycie właściwości. W języku XAML użycie to <object TextElement.Foreground="value".../>, gdzie obiekt jest elementem obiektu (zazwyczaj elementem przepływu) znajdującym się w TextElementobiekcie , a wartość jest ciągiem rozpoznawanym jako Brush wartość implementacji. W kodzie dołączone użycie właściwości jest obsługiwane przez GetForeground metody i SetForeground . Użycie dołączonej właściwości nie jest powszechne, ponieważ większość elementów, które mogą być zawarte w TextElement obsłudze analogiczną nieprzyłączoną Foreground właściwość, której host zawartości używa do renderowania.

Informacje dotyczące właściwości zależności

Pole identyfikatora ForegroundProperty
Właściwości metadanych ustawione na true AffectsRender, Inherits, SubPropertiesDoNotAffectRender

Dotyczy

Produkt Wersje
.NET Framework 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8
Windows Desktop 3.0, 3.1, 5, 6, 7

Zobacz też