Comment créer et appliquer une ressource

Les styles et les modèles pour les éléments sont stockés dans des entités réutilisables appelées ressources. Les styles vous permettent de définir des propriétés d'élément et de réutiliser ces paramètres pour garantir une apparence cohérente entre plusieurs éléments. Un ControlTemplate définit l'apparence d'un contrôle et peut également être appliqué en tant que ressource. Pour plus d'informations, consultez Démarrage rapide : style des contrôles et Démarrage rapide : modèles de contrôle.

Lorsque vous créez une ressource à partir d'une propriété existante, Style ou ControlTemplate, la boîte de dialogue Créer une ressource vous permet de définir la ressource au niveau de l'application, au niveau du document ou au niveau de l'élément. Ces niveaux déterminent où vous pouvez utiliser la ressource. Ainsi, si vous définissez la ressource au niveau de l'élément, celle-ci s'appliquera uniquement à l'élément sur lequel vous l'avez créée. Vous pouvez également choisir de stocker la ressource dans un dictionnaire de ressources, c'est-à-dire un fichier distinct réutilisable dans un autre projet.

Pour créer une ressource

1. Après avoir ouvert un fichier XAML dans le concepteur XAML, créez un élément ou sélectionnez un élément dans la fenêtre Structure du document.

2. Dans la fenêtre Propriétés, cliquez sur le marqueur de propriété à droite d'une valeur de propriété, qui apparaît comme un symbole de case, puis cliquez sur Convertir en nouvelle ressource. Un symbole de case blanche indique une valeur par défaut, et un symbole de case noire indique généralement qu'une ressource locale a été appliquée.

   La boîte de dialogue appropriée pour la création d'une ressource s'affiche. Cette boîte de dialogue apparaît lorsque vous créez une ressource à partir d'un pinceau :

   

3. Dans la zone Nom (Clé), entrez un nom de clé. Il s'agit du nom que vous pouvez utiliser lorsque vous souhaitez que d'autres éléments référencent la ressource.

4. Sous Définir dans, cliquez sur l’option qui spécifie l'endroit où vous souhaitez définir la ressource :

   • Pour mettre la ressource à la disposition d'un document quelconque de votre application, cliquez sur Application.

   • Pour que la ressource soit disponible seulement pour le document actif, cliquez sur Ce document.

   • Pour que la ressource soit disponible seulement pour l'élément à partir duquel vous avez créé la ressource ou pour ses éléments enfants, cliquez sur Ce document puis, dans la liste déroulante, sélectionnez élément : nom.

   • Pour définir la ressource dans un fichier de dictionnaire de ressources qui peut être réutilisé dans d'autres projets, cliquez sur Dictionnaire de ressources, puis sélectionnez un fichier de dictionnaire de ressources existant, tel que StandardStyles.xaml, dans la liste déroulante.

5. Cliquez sur OK pour créer la ressource et appliquer celle-ci à l'élément à partir duquel vous l'avez créée.

Pour appliquer une ressource à un élément ou à une propriété

1. Dans la fenêtre Structure du document, sélectionnez l'élément auquel vous souhaitez appliquer une ressource.

2. Effectuez l'une des opérations suivantes :

   • Appliquez une ressource à une propriété. Dans la fenêtre Propriétés, cliquez sur le marqueur de propriété en regard de la valeur de propriété, pointez sur Ressource locale ou Ressource système, puis cliquez sur une ressource disponible dans la liste qui apparaît.

     Si vous ne voyez pas une ressource que vous pensiez trouver, cela peut être dû au fait que le type de la ressource ne correspond pas au type de la propriété.

   • Appliquez un style ou une ressource de modèle de contrôle à un contrôle. Cliquez avec le bouton droit sur un contrôle dans la fenêtre Structure du document, pointez sur Modifier un modèle ou Modifier des modèles associés, pointez sur Appliquer la ressource, puis cliquez sur le nom du modèle de contrôle dans la liste qui apparaît.

     Notes

     L'option Modifier un modèle permet d'appliquer des modèles de contrôle.L'option Modifier des modèles associés permet d'appliquer d'autres types de modèles.

   Les ressources sont applicables dès lors qu'elles sont compatibles. Ainsi, une ressource pinceau peut être appliquée à la propriété Foreground d'un contrôle TextBox.

Pour modifier une ressource

1. Sélectionnez un élément dans la planche graphique ou dans la fenêtre Structure du document.

2. Cliquez sur le marqueur de propriété Default ou Local situé à droite de la propriété dans la fenêtre Propriétés, puis cliquez sur Modifier la ressource pour ouvrir la boîte de dialogue Modifier la ressource.

3. Modifiez les options de la ressource.

Voir aussi

Concepts

Création d'une interface utilisateur à l'aide du concepteur XAML