Background, propriété
Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez aussi afficher la version anglaise dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte.
Traduction
Anglais
Cette documentation est archivée et n’est pas conservée.

Control.Background, propriété

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

Espace de noms :  System.Windows.Controls
Assembly :  PresentationFramework (dans PresentationFramework.dll)

[BindableAttribute(true)]
public Brush Background { get; set; }

Valeur de propriété

Type : System.Windows.Media.Brush
Le pinceau qui est utilisé pour remplir l'arrière-plan du contrôle. La valeur par défaut est Brushes.Transparent.

Champ d'identificateur

BackgroundProperty

Propriétés de métadonnées définies à true

AffectsRender , SubPropertiesDoNotAffectRender

La propriété Background 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 est modifié. Par exemple, si vous définissez la propriété Background 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 doté d'une capacité de personnalisation d'arrière-plan plus avancée, vous devez définir le style du contrôle.

Cette propriété n'affecte que le contrôle dont le modèle utilise la propriété Background en tant que paramètre. Cette propriété n'a aucun impact sur les autres contrôles.

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


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



Private Sub ChangeBackground(ByVal Sender As Object, ByVal e As RoutedEventArgs)

    If (Equals(btn.Background, Brushes.Red)) Then

        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"

    End If
End Sub



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 appuyé.


<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>


.NET Framework

Pris en charge dans : 4, 3.5, 3.0

.NET Framework Client Profile

Pris en charge dans : 4, 3.5 SP1

Windows 7, Windows Vista SP1 ou ultérieur, Windows XP SP3, Windows Server 2008 (installation minimale non prise en charge), Windows Server 2008 R2 (installation minimale prise en charge avec SP1 ou version ultérieure), Windows Server 2003 SP2

Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.
Afficher:
© 2016 Microsoft