Control.Foreground Propriedade

Definição

Namespace:

Microsoft.UI.Xaml.Controls

Obtém ou define um pincel que descreve a cor de primeiro plano.

public:
 property Brush ^ Foreground { Brush ^ get(); void set(Brush ^ value); };

Brush Foreground();

void Foreground(Brush value);

public Brush Foreground { get; set; }

var brush = control.foreground;
control.foreground = brush;

Public Property Foreground As Brush

<control Foreground="{StaticResource resourceName}"/>
- or -
<control Foreground="colorString"/>
- or -
<control>
  <control.Foreground>singleBrush</control.Foreground>
</control>

Valor da propriedade

Brush

O pincel que pinta o primeiro plano do controle. O valor padrão é um SolidColorBrush com cor preta.

Comentários

Cada controle pode aplicar essa propriedade de forma diferente com base em seu modelo visual. Essa propriedade afeta apenas um controle cujo modelo usa a propriedade Foreground como um parâmetro. Em outros controles, essa propriedade não tem efeito. Normalmente, um controle derivado de ContentControl usa uma extensão de marcação {TemplateBinding} para associar seu valor foreground ao primeiro plano de um ContentPresenter dentro do modelo de controle. A mesma cor/pincel também pode ser usada para valores de outros elementos decorativos no modelo (glifos, ícones, superfícies de controle) ou para compor propriedades de parte, como os elementos ComboBox individuais do controle TimePicker . Para obter mais informações sobre modelos visuais e modelagem de controle, consulte Controles de estilo ou a página de referência da propriedade Template .

A partir do Windows 10, versão 1607 (Software Development Kit do Windows (SDK do Windows) (SDK) versão 10.0.14393.0), generic.xaml inclui recursos que você pode usar para modificar as cores de um controle em diferentes estados visuais sem modificar o modelo de controle. Em aplicativos destinados a esse SDK (software development kit) ou posterior, é preferível modificar esses recursos para definir propriedades como Background, Foreground e BorderBrush. Para obter mais informações, consulte a seção Estilo leve do artigo Controles de estilo.

Confira também

• Pincéis em XAML