Guide pratique pour inclure des ressources au moment de la compilation (C++)

Article
10/12/2023

Par défaut, toutes les ressources se trouvent dans un fichier de script de ressources (.rc), mais il existe de nombreuses raisons de placer des ressources dans un fichier autre que le fichier .rc principal :

Pour ajouter des commentaires aux instructions de ressource qui ne seront pas supprimées lorsque vous enregistrez le fichier .rc.
Pour inclure les ressources qui ont déjà été développées et testées et n’ont pas besoin d’autres modifications. Tous les fichiers inclus, mais qui n’ont pas d’extension .rc, ne peuvent pas être modifiés par les éditeurs de ressources.
Pour inclure des ressources utilisées par différents projets ou qui font partie d’un système de contrôle de version de code source. Ces ressources doivent exister dans un emplacement central où les modifications affecteront tous les projets.
Pour inclure des ressources (telles que des ressources RCDATA) qui sont un format personnalisé. Les ressources RCDATA ont des exigences particulières dans lesquelles vous ne pouvez pas utiliser d’expression comme valeur pour le nameID champ.

Si vous avez des sections dans vos fichiers .rc existants qui répondent à l’une de ces conditions, placez ces sections dans un ou plusieurs fichiers .rc distincts et incluez-les dans votre projet à l’aide de la boîte de dialogue Inclure des ressources.

Ressources inclut

Vous pouvez ajouter des ressources à partir d’autres fichiers à votre projet au moment de la compilation en les répertoriant dans la zone directives de compilation dans la boîte de dialogue Inclure des ressources. Utilisez la boîte de dialogue Inclure des ressources pour modifier l’arrangement de travail normal de l’environnement de projet pour stocker toutes les ressources dans le fichier .rc du projet et tous les symboles dans Resource.h.

Pour commencer, ouvrez la boîte de dialogue Éléments de ressource en cliquant avec le bouton droit sur un fichier .rc en mode Ressource, sélectionnez Resource Include et notez les propriétés suivantes :

Propriété	Description
Fichier d’en-tête de symbole	Vous permet de modifier le nom du fichier d’en-tête où les définitions de symboles de vos fichiers de ressources sont stockées. Pour plus d’informations, consultez Modification des noms des fichiers d’en-tête de symbole.
Directives de symbole en lecture seule	Vous permet d’inclure des fichiers d’en-tête qui contiennent des symboles qui ne doivent pas être modifiés. Par exemple, les fichiers de symboles à partager avec d’autres projets. Cela peut également inclure des fichiers .h MFC. Pour plus d’informations, consultez Inclusion de symboles partagés (en lecture seule) ou calculés.
Directives au moment de la compilation	Vous permet d’inclure des fichiers de ressources créés et modifiés séparément des ressources de votre fichier de ressources principal, contiennent des directives de compilation (telles que ces directives qui incluent des ressources de manière conditionnelle) ou contiennent des ressources dans un format personnalisé. Vous pouvez également utiliser la zone de directives au moment de la compilation pour inclure des fichiers de ressources MFC standard.

Remarque

Les entrées de ces zones de texte apparaissent dans le fichier .rc marqué par TEXTINCLUDE 1, TEXTINCLUDE 2et TEXTINCLUDE 3 respectivement. Pour plus d’informations, consultez TN035 : Utilisation de plusieurs fichiers de ressources et fichiers d’en-tête avec Visual C++.

Une fois les modifications apportées à votre fichier de ressources à l’aide de la boîte de dialogue Inclure des ressources, vous devez fermer et rouvrir le fichier .rc pour que les modifications prennent effet.

Pour inclure des ressources dans votre projet au moment de la compilation

Placez les ressources dans un fichier de script de ressources portant un nom de fichier unique. N’utilisez pas projectname.rc, car il s’agit du nom du fichier utilisé pour le fichier de script de ressource principal.
Cliquez avec le bouton droit sur le fichier .rc dans l’affichage des ressources, puis sélectionnez Éléments de ressource inclus.
Dans la zone Directives au moment de la compilation, ajoutez la directive du compilateur #include pour inclure le nouveau fichier de ressources dans le fichier de ressources principal dans l’environnement de développement.

Les ressources des fichiers inclus de cette façon ne font que partie de l’exécutable au moment de la compilation et ne sont pas disponibles pour la modification ou la modification lorsque vous travaillez sur le fichier .rc principal de votre projet. Les fichiers .rc inclus doivent être ouverts séparément et tous les fichiers inclus sans l’extension .rc ne seront pas modifiables par les éditeurs de ressources.

Pour spécifier des répertoires include pour un fichier de ressource spécifique (.rc)

Cliquez avec le bouton droit sur le fichier .rc dans Explorateur de solutions, puis sélectionnez Propriétés.
Sélectionnez le nœud Ressources dans le volet gauche et spécifiez les répertoires include supplémentaires dans la propriété Autres répertoires Include.

Pour rechercher des symboles dans les ressources

Accédez au menu Modifier>le symbole de recherche.

Conseil

Pour utiliser des expressions régulières dans votre recherche, sélectionnez Rechercher dans les fichiers dans le menu Modifier au lieu de Rechercher un symbole. Sélectionnez la zone Utiliser : Expressions régulières case activée dans la boîte de dialogue Rechercher et dans la zone Rechercher, vous pouvez choisir une expression de recherche régulière dans la liste déroulante. Lorsque vous sélectionnez une expression dans cette liste, elle est remplacée par le texte de recherche dans la zone Rechercher .
Dans la zone Rechercher , sélectionnez une chaîne de recherche précédente dans la liste déroulante ou tapez la touche d’accélérateur que vous souhaitez rechercher, par exemple ID_ACCEL1.
Sélectionnez l’une des options Rechercher , puis choisissez Rechercher suivant.

Remarque

Vous ne pouvez pas rechercher de symboles dans les ressources de type chaîne, accélérateur ou binaire.

Spécifications

Win32

Voir aussi

Fichiers de ressources
Guide pratique pour créer des ressources
Guide pratique pour gérer les ressources