TextBlock.Foreground TextBlock.Foreground TextBlock.Foreground TextBlock.Foreground Property

Definición

Obtiene o establece el Brush que se va a aplicar al contenido de texto del TextBlock.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

Valor de propiedad

Pincel usado para la aplicación al contenido de texto.The brush used to apply to the text contents. De manera predeterminada, es Black.The default is Black.

Ejemplos

El ejemplo siguiente muestra cómo establecer el Foreground atributo de un TextBlock elemento.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>

El ejemplo siguiente muestra cómo establecer el Foreground propiedad mediante programación.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

Comentarios

Para una tabla de muestras que se muestran los colores de pincel predefinidos disponibles, consulte Brushes.For a table of swatches that show the available pre-defined brush colors, see Brushes.

Cualquier Foreground en elementos secundarios invalida esta configuración de nivel superior.Any Foreground settings on child elements override this top-level setting.

Esta propiedad de dependencia también tiene un uso de la propiedad adjunta.This dependency property also has an attached property usage. En XAMLXAML, el uso es <object TextBlock.Foreground="value".../>, donde objeto es un elemento de objeto (normalmente un elemento de flujo) dentro de un TextBlock, y valor es una cadena que se resuelve en un Brush valor de la implementación.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. En el código, el uso de la propiedad adjunta es compatible con GetForeground y SetForeground.In code, the attached property usage is supported by GetForeground and SetForeground. El uso de la propiedad adjunta no es común, porque la mayoría de los elementos que puede incluirse en un TextBlock soporte un análogo nonattached Foreground propiedad, que el TextBlock utiliza para la representación.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.

Información sobre propiedades de dependenciaDependency Property Information

Campo de identificadorIdentifier field ForegroundProperty
Establecen las propiedades de metadatos en trueMetadata properties set to true AffectsRender, SubPropertiesDoNotAffectRender, InheritsAffectsRender, SubPropertiesDoNotAffectRender, Inherits

Se aplica a