TextBlock.Foreground Property

Definition

Ruft das Brush-Objekt ab, das auf den Textinhalt des TextBlock-Objekts angewendet werden soll, oder legt es fest.Gets or sets the Brush to apply to the text contents of the 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

Property Value

Brush

Der Pinsel, der auf den Textinhalt angewendet werden soll.The brush used to apply to the text contents. Der Standardwert lautet Black.The default is Black.

Examples

Im folgenden Beispiel wird gezeigt, wie das Foreground-Attribut eines TextBlock-Elements festgelegt wird.The following example shows how to set the Foreground attribute of a TextBlock element.

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

Im folgenden Beispiel wird gezeigt, wie die Foreground-Eigenschaft Programm gesteuert festgelegt wird.The following example shows how to set the Foreground property programmatically.

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

Remarks

Eine Tabelle mit Dragquellen, die die verfügbaren vordefinierten Pinsel Farben anzeigen, finden Sie unter Brushes.For a table of swatches that show the available pre-defined brush colors, see Brushes.

Alle Foreground Einstellungen für untergeordnete Elemente überschreiben diese Einstellung auf oberster Ebene.Any Foreground settings on child elements override this top-level setting.

Diese Abhängigkeits Eigenschaft verfügt auch über eine angefügte Eigenschaften Verwendung.This dependency property also has an attached property usage. In XAMLXAMLwird die Verwendung <object TextBlock.Foreground="value".../>, wobei Object ein Objekt Element (in der Regel ein Fluss Element) ist, das in einem TextBlockenthalten ist, und value eine Zeichenfolge ist, die zu einem Brush Implementierungs Wert aufgelöst wird.In XAMLXAML, the usage is <object TextBlock.Foreground="value".../>, where object is an object element (typically a flow element) contained within a TextBlock, and value is a string that resolves to a Brush implementation value. Im Code wird die Verwendung der angefügten Eigenschaft von GetForeground und SetForegroundunterstützt.In code, the attached property usage is supported by GetForeground and SetForeground. Die Verwendung der angefügten Eigenschaft ist nicht üblich, weil die meisten Elemente, die in einem TextBlock enthalten sein können, eine analoge nicht angefügte Foreground Eigenschaft unterstützen, die vom TextBlock zum Rendern verwendet wird.The attached property usage is not common, because most elements that can be contained in a TextBlock support an analogous nonattached Foreground property, which the TextBlock uses for rendering.

Informationen zur AbhängigkeitseigenschaftDependency Property Information

BezeichnerfeldIdentifier field ForegroundProperty
Metadateneigenschaften auf true festgelegtMetadata properties set to true AffectsRender, SubPropertiesDoNotAffectRender, InheritsAffectsRender, SubPropertiesDoNotAffectRender, Inherits

Applies to