Control.Background, propriété
Mise à jour : novembre 2007
Obtient ou définit un pinceau qui décrit l'arrière-plan d'un contrôle. Il s'agit d'une propriété de dépendance.
Assembly : PresentationFramework (dans PresentationFramework.dll)
/** @property */ /** @attribute BindableAttribute(true) */ public Brush get_Background() /** @property */ /** @attribute BindableAttribute(true) */ public void set_Background(Brush value)
public function get Background () : Brush public function set Background (value : Brush)
Pour plus d'informations sur XAML, consultez le type Brush.
Valeur de propriété
Type : System.Windows.Media.BrushLe pinceau qui est utilisé pour remplir l'arrière-plan du contrôle. La valeur par défaut est Brushes.Transparent.
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>
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>
Windows Vista
Le .NET Framework et le .NET Compact Framework ne prennent pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.
