TextElement.Foreground TextElement.Foreground TextElement.Foreground TextElement.Foreground Property

Definición

Obtiene o establece Brush que se aplica al contenido del elemento.Gets or sets the Brush to apply to the content of the element.

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

En el ejemplo siguiente se muestra cómo establecer Foreground el atributo, Paragraph utilizando como elemento de ejemplo.The following example shows how to set the Foreground attribute, using Paragraph as the example element.

<FlowDocumentReader>
  <FlowDocument>
    <Paragraph
      Background="Bisque"
      Foreground="DarkGreen"
      Padding="4"
    >
      <Run>
        This text has a foreground color of dark green, and a background color of bisque.
      </Run>
    </Paragraph>
  </FlowDocument>
</FlowDocumentReader>

En la ilustración siguiente se muestra cómo se representa el ejemplo anterior.The following figure shows how the preceding example renders.

![Captura Primer plano de la captura de]pantalla de bisque(~/add/media/textelement-foreback.png "de fondo verde: Primer plano del Bisque de fondo verde")Screenshot: Foreground of green, background bisque

En el ejemplo siguiente se muestra cómo establecer Foreground la propiedad mediante programación.The following example shows how to set the Foreground property programmatically.

Run run = new Run(
    "This text has a foreground color of dark green, and a background color of bisque.");
Paragraph par = new Paragraph(run);

par.Background = Brushes.Bisque;
par.Foreground = Brushes.DarkGreen;
Dim run As New Run("This text has a foreground color of dark green, and a background color of bisque.")
Dim par As New Paragraph(run)

par.Background = Brushes.Bisque
par.Foreground = Brushes.DarkGreen

Comentarios

Para obtener una tabla de muestras que muestren los colores de pincel predefinidos Brushesdisponibles, vea.For a table of swatches that shows the available predefined brush colors, see Brushes.

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 TextElement.Foreground="value".../>, donde el objeto es un elemento de objeto (normalmente un elemento de flujo) TextElementcontenido dentro de un, y el valor es una cadena que Brush se resuelve como un valor de implementación.In XAMLXAML, the usage is <object TextElement.Foreground="value".../>, where object is an object element (typically a flow element) contained within a TextElement, and value is a string that resolves to a Brush implementation value. En el código, el uso de la propiedad adjunta es GetForeground compatible SetForeground con los métodos y.In code, the attached property usage is supported by the GetForeground and SetForeground methods. El uso de la propiedad adjunta no es habitual, porque la mayoría de los elementos que TextElement se pueden incluir en un Foreground admiten una propiedad no adjunta análoga, que el host de contenido utiliza para la representación.The attached property usage is not common, because most elements that can be contained in a TextElement support an analogous nonattached Foreground property, which the content host uses for rendering.

Información sobre propiedades de dependenciaDependency Property Information

Campo de identificadorIdentifier field ForegroundProperty
Propiedades de metadatos establecidas entrueMetadata properties set to true AffectsRender, Inherits, SubPropertiesDoNotAffectRenderAffectsRender, Inherits, SubPropertiesDoNotAffectRender

Se aplica a

Consulte también: