SystemColors.AppWorkspaceBrushKey, propriété

Utilisez le AppWorkspaceBrushKey pour créer une référence dynamique au pinceau système de l'espace de travail d'application. Cette référence dynamique se met automatiquement à jour si le pinceau est modifié. Pour créer une référence statique qui ne se met pas automatiquement à jour, utilisez AppWorkspaceBrush.

La classe SystemColors fournit l'accès aux pinceaux et couleurs système, tels que ControlBrush, ControlBrushKey et DesktopBrush. Un pinceau système est un objet SolidColorBrush qui peint une zone avec la couleur système spécifiée. Un pinceau système produit toujours un remplissage solide ; il ne peut pas être utilisé pour créer un gradient.

Vous pouvez utiliser des pinceaux système comme une ressource statique ou dynamique. Utilisez une ressource dynamique si vous souhaitez que le pinceau se mette à jour automatiquement si l'utilisateur le modifie pendant l'exécution de l'application ; sinon, utilisez une ressource statique. La classe SystemColors contient diverses propriétés statiques qui suivent une stricte convention d'affectation de noms :

• <SystemColor>Brush

  Récupère une référence statique à un SolidColorBrush de la couleur système spécifiée.

• <SystemColor>BrushKey

  Récupère une référence dynamique à un SolidColorBrush de la couleur système spécifiée.

• <SystemColor>Color

  Récupère une référence statique à une structure Color de la couleur système spécifiée.

• <SystemColor>ColorKey

  Récupère une référence dynamique à la structure Color de la couleur système spécifiée.

Une couleur système est une structure Color pouvant être utilisée pour configurer un pinceau. Par exemple, vous pouvez créer un gradient à l'aide de couleurs système en définissant les propriétés Color des points de dégradé d'un objet LinearGradientBrush avec les couleurs système. Pour obtenir un exemple, consultez Comment : utiliser des couleurs système dans un dégradé.

L'exemple suivant utilise une référence dynamique du pinceau système pour définir l'arrière-plan d'un bouton.

<Page xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" 
  xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
  WindowTitle="SystemColors Example" Background="White">  
  <StackPanel Margin="20">

    <!-- Uses a dynamic resource to set the 
         background of a button. 
         If the desktop brush changes while this application
         is running, this button will be updated. -->
    <Button 
      Background="{DynamicResource {x:Static SystemColors.DesktopBrushKey}}" 
      Content="Hello, World!" />

  </StackPanel>
</Page>

L'exemple suivant utilise une référence statique du pinceau système pour définir l'arrière-plan d'un bouton.

<Page xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" 
  xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
  WindowTitle="SystemColors Example" Background="White">  
  <StackPanel Margin="20">

    <!-- Uses a static brush to set the
         background of a button. 
         If the desktop brush changes while this application
         is running, this button will not be updated until
         the page is loaded again. -->
    <Button 
      Background="{x:Static SystemColors.DesktopBrush}" 
      Content="Hello, World!"  /> 

  </StackPanel>
</Page>

Pour obtenir un exemple montrant comment utiliser une couleur système dans un gradient, consultez Comment : utiliser des couleurs système dans un dégradé.

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

Référence

Autres ressources