TextBlock.Foreground Właściwość

Definicja

Pobiera lub ustawia element Brush do zastosowania do zawartości tekstowej obiektu TextBlock.

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

Wartość właściwości

Pędzel używany do zastosowania do zawartości tekstowej. Wartość domyślna to Black.

Przykłady

W poniższym przykładzie pokazano, jak ustawić Foreground atrybut TextBlock elementu.

XAML
<TextBlock 
  Name="textBlock"
  
  Background="AntiqueWhite" 
  Foreground="Navy" 
  
  FontFamily="Century Gothic"
  FontSize="12"
  FontStretch="UltraExpanded"
  FontStyle="Italic"
  FontWeight="UltraBold"
  
  LineHeight="Auto"
  Padding="5,10,5,10"
  TextAlignment="Center"
  TextWrapping="Wrap"
  
  Typography.NumeralStyle="OldStyle"
  Typography.SlashedZero="True"
>
  <Run Background="LightGreen">Text run 1.</Run>
  <LineBreak/><Run Background="LightBlue">Text run 2.</Run>
  <LineBreak/><Run Background="LightYellow">Text run 3.</Run>
</TextBlock>

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

C#
TextBlock textBlock = new TextBlock(new Run("A bit of text content..."));

textBlock.Background              = Brushes.AntiqueWhite;
textBlock.Foreground              = Brushes.Navy;

textBlock.FontFamily              = new FontFamily("Century Gothic");
textBlock.FontSize                = 12;
textBlock.FontStretch             = FontStretches.UltraExpanded;
textBlock.FontStyle               = FontStyles.Italic;
textBlock.FontWeight              = FontWeights.UltraBold;

textBlock.LineHeight              = Double.NaN;
textBlock.Padding                 = new Thickness(5, 10, 5, 10);
textBlock.TextAlignment           = TextAlignment.Center;
textBlock.TextWrapping            = TextWrapping.Wrap;

textBlock.Typography.NumeralStyle = FontNumeralStyle.OldStyle;
textBlock.Typography.SlashedZero  = true;

Uwagi

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

Wszystkie Foreground ustawienia elementów podrzędnych zastępują to ustawienie najwyższego poziomu.

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 TextBlock.Foreground="value".../>, gdzie obiekt jest elementem obiektu (zazwyczaj elementem przepływu) zawartym w TextBlockobiekcie , a wartość jest ciągiem rozpoznawanym jako Brush wartość implementacji. W kodzie użycie dołączonej właściwości jest obsługiwane przez GetForeground elementy i SetForeground. Użycie dołączonej właściwości nie jest powszechne, ponieważ większość elementów, które mogą być zawarte w TextBlock obsłudze analogiczną nieprzyłączoną Foreground właściwość, która TextBlock jest używana do renderowania.

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

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

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, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9