Freigeben über

TextBlock.Foreground Eigenschaft

Definition

Namespace:
System.Windows.Controls
Assembly:
PresentationFramework.dll

Dient zum Abrufen oder Festlegen des Brush Zuweisens auf den Textinhalt der .TextBlock

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 zum Anwenden auf den Textinhalt verwendet wird. Der Standardwert lautet 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 die Foreground-Eigenschaft programmgesteuert festgelegt wird.

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 Farbmustern, die die verfügbaren vordefinierten Pinselfarben anzeigen, finden Sie unter Brushes.

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

Diese Abhängigkeitseigenschaft verfügt auch über eine angefügte Eigenschaftsnutzung. In XAML ist <object TextBlock.Foreground="value".../>die Verwendung , wobei objekt ein Objektelement (in der Regel ein Flusselement) in einem TextBlock, und Wert eine Zeichenfolge ist, die in einen Brush Implementierungswert aufgelöst wird. Im Code wird die Verwendung angefügter Eigenschaften von GetForeground und SetForeground. Die Verwendung angefügter Eigenschaften ist nicht üblich, da die meisten Elemente, die in einer TextBlock analogen nicht angefügten Foreground Eigenschaft enthalten sein können, unterstützt werden können, die für das TextBlock Rendern verwendet wird.

Informationen zur Abhängigkeitseigenschaft

Element Wert
Bezeichnerfeld ForegroundProperty
Auf Metadateneigenschaften festgelegt true AffectsRender, SubPropertiesDoNotAffectRenderInherits

Gilt für: