TextElement.Foreground Propriedade

Referência

Definição

Namespace:: System.Windows.Documents

Assembly:: PresentationFramework.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

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

Background