Control.Background Propriedade

Definição

Namespace:

System.Windows.Controls

Assembly:

PresentationFramework.dll

Obtém ou define um pincel que descreve a tela de fundo de um controle.

C#

[System.ComponentModel.Bindable(true)]
public System.Windows.Media.Brush Background { get; set; }

Valor da propriedade

Brush

O pincel usado para preencher a tela de fundo do controle. O padrão é Transparent.

Atributos

BindableAttribute

Exemplos

O exemplo a seguir mostra como definir a propriedade em segundo plano de um controle.

XAML

<Button Name="btn" Background="Red" 
        Click="ChangeBackground">
  Background
</Button>

C#

void ChangeBackground(object sender, RoutedEventArgs e)
{
    if (btn.Background == Brushes.Red)
    {
        btn.Background = new LinearGradientBrush(Colors.LightBlue, Colors.SlateBlue, 90);
        btn.Content = "Control background changes from red to a blue gradient.";
    }
    else
    {
        btn.Background = Brushes.Red;
        btn.Content = "Background";
    }
}

O exemplo a seguir mostra um modelo que permite que um gatilho altere a tela de fundo de um botão quando ele é pressionado.

XAML

<Button FontSize="16" FontWeight="Bold">Click the Background
  <Button.Template>
    <ControlTemplate TargetType="{x:Type Button}">
      <Border Background="{TemplateBinding Background}">
         <ContentPresenter/>
      </Border>
    </ControlTemplate>
  </Button.Template>

  <Button.Style>
    <Style TargetType="{x:Type Button}">
      <Setter Property="Background" Value="Blue"/>
      <Style.Triggers>
        <Trigger Property="IsPressed" Value="true">
          <Setter Property="Background" Value="Red"/>
        </Trigger>
      </Style.Triggers>
    </Style>
  </Button.Style>
</Button>

Comentários

A Background propriedade se aplica somente ao estado de descanso de um controle. O estilo padrão do controle especifica sua aparência quando o estado do controle é alterado. Por exemplo, se você definir a Background propriedade em um Button, o botão terá esse valor somente quando não estiver pressionado ou desabilitado. Se você quiser criar um controle que tenha uma personalização mais avançada da tela de fundo, defina o estilo do controle.

Essa propriedade afeta apenas um controle cujo modelo usa a Background propriedade como parâmetro. Em outros controles, essa propriedade não tem impacto.

Informações da propriedade de dependência

Campo identificador	BackgroundProperty
Propriedades de metadados definidas como true	AffectsRender, SubPropertiesDoNotAffectRender

Aplica-se a