Informations
Le sujet que vous avez demandé est indiqué ci-dessous. Toutefois, ce sujet ne figure pas dans la bibliothèque.

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.

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

[BindableAttribute(true)]
public Brush Background { get; set; }
/** @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.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 ayant la valeur 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>


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.

.NET Framework

Pris en charge dans : 3.5, 3.0

Ajouts de la communauté

Afficher:
© 2014 Microsoft