Créer et appliquer une ressource
Les styles et les modèles des éléments du concepteur XAML sont stockés dans des entités réutilisables appelées ressources. Les styles vous permettent de définir les propriétés des éléments et de réutiliser ces paramètres pour que l'apparence des différents éléments demeure cohérente. Un ControlTemplate définit l’apparence d’un contrôle et peut également être appliqué en tant que ressource. Pour plus d’informations, consultez Styles XAML et Modèles de contrôles.
Quand 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, du document ou de l’élément. Ces niveaux déterminent où vous pouvez utiliser la ressource. Par exemple, si vous définissez la ressource au niveau de l'élément, elle peut être appliquée uniquement à l'élément sur lequel vous l'avez créée. Vous pouvez également choisir de stocker la ressource dans un dictionnaire de ressources. Il s'agit d'un fichier distinct que vous pouvez réutiliser dans un autre projet.
Créer une nouvelle ressource
Après avoir ouvert un fichier XAML dans le concepteur XAML, créez un élément ou choisissez un élément dans la fenêtre Structure du document.
Dans la fenêtre Propriétés, choisissez le marqueur de propriété, qui apparaît sous la forme d’un symbole de boîte à droite d’une valeur de propriété, puis choisissez Convertir en nouvelle ressource. Un symbole de zone blanche indique une valeur par défaut, tandis qu’un symbole de zone 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 quand vous créez une ressource à partir d'un pinceau :
Dans la zone Nom (Clé), entrez un nom de clé. C'est le nom que vous pouvez utiliser pour que d'autres éléments fassent référence à la ressource.
Sous Définir dans, choisissez l’option qui spécifie où vous voulez définir la ressource :
Pour que la ressource soit disponible pour n’importe quel document dans votre application, choisissez Application.
Pour qu’elle soit disponible seulement pour le document actif, choisissez Ce document.
Pour qu’elle soit disponible seulement pour l’élément à partir duquel vous l’avez créée ou pour ses éléments enfants, choisissez 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. Sélectionnez ensuite un fichier de dictionnaire de ressources existant, par exemple StandardStyles.xaml, dans la liste déroulante.
Choisissez le bouton OK pour créer la ressource et l’appliquer à l’élément à partir duquel vous l’avez créée.
Appliquer une ressource à un élément ou à une propriété
Dans la fenêtre Structure du document, choisissez l’élément auquel vous souhaitez appliquer une ressource.
Effectuez l'une des opérations suivantes :
Appliquer 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é, choisissez Ressource locale ou Ressource système, puis sélectionnez une ressource disponible dans la liste qui apparaît.
L’absence d’une ressource peut s’expliquer par le fait que son type ne correspond pas au type de la propriété.
Appliquer une ressource de modèle de style ou de contrôle à un contrôle. Ouvrez le menu contextuel (clic droit) d’un des contrôles de la fenêtre Structure du document, choisissez Modifier le modèle ou Modifier d’autres modèles, Appliquer la ressource, puis le nom du modèle de contrôle dans la liste qui s’affiche.
Notes
Modifier le modèle applique des modèles de contrôle. Modifier d’autres modèles applique d’autres types de modèle.
Vous pouvez appliquer des ressources partout où elles sont compatibles. Par exemple, vous pouvez appliquer une ressource de pinceau à la propriété Foreground d’un contrôle TextBox.
Modifier une ressource
Choisissez un élément sur la planche graphique ou dans la fenêtre Structure du document.
Choisissez le marqueur de propriété Par défaut ou Local à droite de la propriété dans la fenêtre Propriétés, puis choisissez Modifier la ressource pour ouvrir la boîte de dialogue Modifier la ressource.
Modifiez les options de la ressource.