TextElement.Foreground Propriedade

Definição

Namespace:

System.Windows.Documents

Assembly:

PresentationFramework.dll

Obtém ou define o pincel a ser aplicado ao conteúdo do elemento.

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

Brush

O pincel usado para aplicar ao conteúdo do texto. O padrão é Black.

Exemplos

O exemplo a seguir mostra como definir o atributo Foreground, usando Paragraph como o elemento de exemplo.

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

A figura a seguir mostra como o exemplo anterior é renderizado.

O exemplo a seguir mostra como definir a propriedade Foreground programaticamente.

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

Comentários

Para obter uma tabela de amostras que mostra as cores de pincel predefinidas disponíveis, consulte Brushes.

Essa propriedade de dependência também tem um uso de propriedade anexada. No XAML, o uso é <object TextElement.Foreground="value".../>, em que o objeto é um elemento de objeto (normalmente um elemento de fluxo) contido em um TextElement, e o valor é uma cadeia de caracteres que resolve para um Brush valor de implementação. No código, o uso da propriedade anexada é compatível com os métodos e SetForeground os GetForeground métodos. O uso da propriedade anexada não é comum, pois a maioria dos elementos que podem ser contidos em uma TextElement propriedade nãonattached Foreground análoga, que o host de conteúdo usa para renderização.

Informações da propriedade Dependency

Item	Valor
Campo identificador	ForegroundProperty
Propriedades de metadados definidas como true	AffectsRender, , InheritsSubPropertiesDoNotAffectRender

Confira também

• Background