Compartilhar via


TextElement.Foreground Propriedade

Definição

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 o conteúdo de texto. O padrão é Black.

Exemplos

O exemplo a seguir mostra como definir o Foreground atributo, 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.

Captura de tela: Verde em primeiro plano, bisque em segundo plano

O exemplo a seguir mostra como definir a Foreground propriedade 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 anexado. No XAML, o uso é <object TextElement.Foreground="value".../>, onde 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 valor de Brush 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 de dependência

Campo Identificador ForegroundProperty
Propriedades de metadados definidas como true AffectsRender, Inherits, SubPropertiesDoNotAffectRender

Aplica-se a

Confira também