TextElement.Foreground Propriedade

Definição

Obtém ou configura o pincel para aplicar 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 de Propriedade

O pincel usado para aplicar ao conteúdo do texto. A predefiniçã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 seguinte mostra como o exemplo anterior se apresenta.

Captura de ecrã: Primeiro plano do verde, bisque de fundo

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

Observações

Para uma tabela de amostras que mostra as cores pré-definidas disponíveis, veja Brushes.

Esta propriedade de dependência também tem um uso associado à propriedade. Em XAML, a utilização é <object TextElement.Foreground="value".../>, onde o objeto é um elemento de objeto (tipicamente um elemento de fluxo) contido num TextElement, e o valor é uma cadeia que resolve para um Brush valor de implementação. No código, o uso da propriedade associada é suportado pelos GetForeground métodos e.SetForeground O uso de propriedades anexadas não é comum, porque a maioria dos elementos que podem ser contidos num TextElement suporte suporta uma propriedade não anexada Foreground análoga, que o anfitrião de conteúdo usa para renderização.

Informação de Propriedade de Dependência

Iteme Value
Campo identificador ForegroundProperty
Propriedades dos metadados definidas como true AffectsRender, Inherits, SubPropertiesDoNotAffectRender

Aplica-se a

Ver também