TextBlock.Foreground Eigenschaft

Definition

Namespace:

System.Windows.Controls

Assembly:

PresentationFramework.dll

Ruft das Brush-Objekt ab, das auf den Textinhalt des TextBlock-Objekts angewendet werden soll, oder legt es fest.

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

Eigenschaftswert

Brush

Der Pinsel, der auf den Textinhalt angewendet werden soll. Der Standardwert ist Black.

Beispiele

Das folgende Beispiel zeigt, wie das Foreground Attribut eines TextBlock Elements festgelegt wird.

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

Das folgende Beispiel zeigt, wie Sie die Foreground-Eigenschaft programmatisch einstellen können.

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;

Dim textBlock As 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

Hinweise

Eine Tabelle mit Farbfeldern, die die verfügbaren vordefinierten Pinselfarben anzeigen, finden Sie unter Brushes.

Alle Foreground Einstellungen für untergeordnete Elemente setzen diese Einstellung der obersten Ebene außer Kraft.

Diese Abhängigkeitseigenschaft verfügt auch über eine angefügte Eigenschaftsverwendung. In XAML wird <object TextBlock.Foreground="value".../>verwendet, wobei object ein Objektelement (in der Regel ein Flowelement) ist, das in einem TextBlockenthalten ist, und wert eine Zeichenfolge, die in einen Brush Implementierungswert aufgelöst wird. Im Code wird die Verwendung angefügter Eigenschaften von GetForeground und SetForegroundunterstützt. Die Verwendung angefügter Eigenschaften ist nicht üblich, da die meisten Elemente, die in einem TextBlock enthalten sein können, eine analoge nicht angefügte Foreground Eigenschaft unterstützen, die zum TextBlock Rendern verwendet wird.

Informationen zur Abhängigkeitseigenschaft

Bezeichnerfeld	ForegroundProperty
Metadateneigenschaften auf true festgelegt	AffectsRender, SubPropertiesDoNotAffectRender, Inherits