Control.Background Propriété

Définition

Espace de noms:

System.Windows.Controls

Assembly:

PresentationFramework.dll

Obtient ou définit un pinceau qui décrit l'arrière-plan d'un contrôle.

C#

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

Valeur de propriété

Brush

Le pinceau qui est utilisé pour remplir l'arrière-plan du contrôle. La valeur par défaut est Transparent.

Attributs

BindableAttribute

Exemples

L’exemple suivant montre comment définir la propriété d’arrière-plan d’un contrôle.

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";
    }
}

L’exemple suivant montre un modèle qui permet à un déclencheur de modifier l’arrière-plan d’un bouton lorsqu’il est enfoncé.

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>

Remarques

La Background propriété s’applique uniquement à l’état de repos d’un contrôle. Le style par défaut du contrôle spécifie son apparence lorsque l’état du contrôle change. Par exemple, si vous définissez la Background propriété sur un Button, le bouton a cette valeur uniquement lorsqu’il n’est pas appuyé ou désactivé. Si vous souhaitez créer un contrôle qui a une personnalisation plus avancée de l’arrière-plan, vous devez définir le style du contrôle.

Cette propriété affecte uniquement un contrôle dont le modèle utilise la Background propriété comme paramètre. Sur d’autres contrôles, cette propriété n’a aucun impact.

Informations sur les propriétés de dépendance

Champ Identificateur	BackgroundProperty
Propriétés de métadonnées définies sur true	AffectsRender, SubPropertiesDoNotAffectRender

S’applique à