TextBlock.Foreground Propiedad

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

Brush

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

En el ejemplo siguiente se 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>

En el ejemplo siguiente se muestra cómo establecer la 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 obtener una tabla de muestras que muestren los colores de pincel predefinidos disponibles, vea Brushes .For a table of swatches that show the available pre-defined brush colors, see Brushes.

Cualquier Foreground configuración de los 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 XAML, el uso es <object TextBlock.Foreground="value".../> , donde el objeto es un elemento de objeto (normalmente un elemento de flujo) contenido dentro de un TextBlock , y el valor es una cadena que se resuelve como un Brush valor de implementación.In XAML, 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 habitual, porque la mayoría de los elementos que se pueden incluir en un TextBlock admiten una propiedad no adjunta análoga Foreground , que 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
Propiedades de metadatos establecidas en trueMetadata properties set to true AffectsRender, SubPropertiesDoNotAffectRender, InheritsAffectsRender, SubPropertiesDoNotAffectRender, Inherits

Se aplica a