Guide pratique pour créer des ressources (C++)

Vous pouvez créer des ressources pour votre projet en :

  • Utilisation d’un fichier de script de ressource.

    Remarque

    Cette étape est nécessaire avant d’ajouter des ressources.

  • Ajout de ressources à votre projet et utilisation de l’affichage des ressources.

  • Utilisation d’un modèle de ressource pour créer des ressources personnalisées.

Utiliser des fichiers de script de ressources

Avant de créer et d’ajouter de nouvelles ressources à votre projet, vous devez d’abord créer un fichier de script de ressources (.rc).

Remarque

Vous pouvez uniquement ajouter un fichier de script de ressource à un projet existant chargé dans l’IDE Visual Studio. Vous ne pouvez pas créer de script de ressource autonome en dehors du projet, bien que les fichiers de modèle de ressource (.rct) puissent être créés à tout moment.

Pour créer un fichier de script de ressource

  1. Concentrez-vous sur votre dossier de projet existant dans Explorateur de solutions, par exemple, MyProject.

    Remarque

    Ne confondez pas le dossier du projet avec le dossier solution dans Explorateur de solutions. Si vous placez le focus sur le dossier Solution , vous n’aurez pas les mêmes choix Ajouter un nouvel élément .

  2. Dans le menu, accédez à Project>Add New Item.

  3. Sélectionnez le dossier Visual C++ et choisissez Fichier de ressources (.rc) dans le volet droit.

  4. Indiquez un nom pour votre fichier de script de ressource dans la zone de texte Nom , puis sélectionnez Ouvrir.

Pour ouvrir un fichier de script de ressource

Vous pouvez afficher les ressources dans un fichier de script de ressources sans ouvrir un projet. Le fichier de script s’ouvre dans une fenêtre de document par opposition à la vue des ressources.

Remarque

Certaines commandes ne sont disponibles que si le fichier est ouvert autonome, ce qui signifie qu’en dehors d’un projet sans d’abord charger le projet. Par exemple, pour utiliser la commande Enregistrer sous et enregistrer un fichier avec un autre format ou nom de fichier, le fichier doit être ouvert autonome.

  • Pour ouvrir un fichier de script de ressource en dehors d’un projet, dans le menu, accédez à Fichier>Ouvert, puis choisissez Fichier. Accédez au fichier de script de ressource, mettez en surbrillance le fichier, puis choisissez Ouvrir.

    Remarque

    Il peut arriver que vous souhaitiez afficher le contenu du fichier de script de ressources de votre projet sans utiliser les éditeurs de ressources pour ouvrir une ressource. Par exemple, vous souhaitez rechercher une chaîne dans toutes les boîtes de dialogue du fichier de ressources sans avoir à ouvrir chacune d'elles séparément. Vous pouvez facilement ouvrir le fichier de ressources au format texte pour afficher toutes les ressources qu’il contient et effectuer des opérations globales prises en charge par l’éditeur de texte.

    Pour ouvrir un fichier de script de ressources au format texte, utilisez la flèche déroulante située à droite du bouton Ouvrir à l’étape ci-dessus et choisissez Ouvrir avec. Sélectionnez l’éditeur de code source (texte) et, dans la liste déroulante Ouvrir sous , sélectionnez Texte et la ressource s’ouvre dans l’éditeur de code source.

  • Pour ouvrir plusieurs scripts de ressources, suivez la même étape ci-dessus pour chaque fichier que vous souhaitez ouvrir, par exemple Source1.rc et Source2.rc. Ensuite, lorsque les deux fichiers .rc sont ouverts dans des fenêtres de documents distincts, utilisez le menu Fenêtre ou cliquez avec le bouton droit sur l’un des fichiers, puis choisissez Nouveau groupe d’onglets horizontaux ou Nouveau groupe d’onglets verticaux. Les fenêtres sont désormais en mosaïque pour pouvoir les afficher simultanément.

Conseil

Vous pouvez ouvrir des fichiers de script de ressources en cliquant avec le bouton droit sur le fichier .rc dans Explorateur de solutions, en sélectionnant Ouvrir avec et en choisissant l’Éditeur de code source (texte).

Lorsque vous générez une application Microsoft Foundation Class (MFC) pour Windows à l’aide de l’Assistant Application MFC, l’Assistant génère un ensemble de fichiers de base, y compris un fichier de script de ressources (.rc) qui contient les principales fonctionnalités de la MFC. Toutefois, ces fonctionnalités spécifiques à MFC ne sont pas disponibles lors de la modification d’un fichier .rc pour les applications Windows non basées sur MFC. Cela inclut les Assistants de code, les chaînes d’invite de menus, le contenu de liste pour les contrôles de zone de liste modifiable et l’hébergement de contrôle ActiveX.

  • Pour ajouter la prise en charge de MFC, avec le fichier de script de ressource ouvert, dans l’affichage des ressources, mettez en surbrillance le dossier des ressources (par exemple, MFC.rc). Ensuite, dans le Fenêtre Propriétés, définissez le mode MFC sur True.

    Remarque

    En plus de définir le mode MFC, le fichier .rc doit faire partie d’un projet MFC. La définition uniquement du mode MFC sur True sur un fichier .rc dans un projet Win32 ne vous donnera pas de fonctionnalités MFC.

Créer des ressources

Vous pouvez créer une ressource en tant que nouvelle ressource par défaut, ce qui signifie qu’une ressource qui n’est pas basée sur un modèle, ou en tant que ressource modèle après un modèle.

Utilisez la fenêtre Vue des ressources pour afficher les fichiers de ressources inclus dans vos projets. Le développement du dossier supérieur, par exemple , Project1.rc, affiche les types de ressources dans ce fichier. Développez chaque type de ressource pour afficher les ressources individuelles de ce type.

Conseil

Pour ouvrir la fenêtre Affichage des ressources, accédez au menu Afficher>l’affichage d’autres ressources Windows>ou appuyez sur Ctrl+Maj+E.

Vous pouvez également utiliser le bouton droit sur la fenêtre Affichage des ressources pour lancer un menu contextuel de commandes, ou double-cliquez sur la barre de titre pour ancrer et détacher la fenêtre. Cliquez avec le bouton droit sur la barre de titre pour les commandes qui contrôlent le comportement de la fenêtre. Pour plus d’informations, consultez Gestion Windows.

Les fenêtres Affichage des ressources incluent la boîte de dialogue Ajouter une ressource avec les propriétés suivantes pour ajouter des ressources à un projet d’application de bureau Windows C++ :

Propriété Description
Type de ressource Spécifiez le type de ressource que vous souhaitez créer.

Vous pouvez développer les catégories de ressources du curseur et de la boîte de dialogue pour afficher des ressources supplémentaires, qui se trouvent dans .. \Microsoft Visual Studio <version>\VC\VCResourceTemplates\<LCID>\mfc.rct. Si vous devez ajouter des fichiers .rct, placez-les ici ou spécifiez un autre chemin d’accès include. Les ressources affichées au niveau supérieur dans le contrôle d’arborescence sont les ressources par défaut fournies par Visual Studio. Les ressources dans les fichiers .rct apparaissent au deuxième niveau sous la catégorie appropriée. Il n’existe aucune limite prédéfinie au nombre de fichiers .rct que vous pouvez ajouter.

Nouveau Créez une ressource en fonction du type sélectionné dans la zone Type de ressource et ouvrez la ressource dans l’éditeur approprié.

Par exemple, si vous créez une ressource de boîte de dialogue, elle ouvre la ressource dans l’Éditeur de boîte de dialogue.
Importer Ouvrez la boîte de dialogue Importer pour accéder à la ressource que vous souhaitez importer dans votre projet actuel.

Vous pouvez importer une image bitmap, une icône, un curseur, du code HTML, un son (. WAV) ou fichier de ressources personnalisé.
Personnalisée Ouvrez la boîte de dialogue Nouvelle ressource personnalisée pour créer une ressource personnalisée.

Inclut également une propriété Resource Type qui fournit une zone de texte pour vous permettre d’entrer le nom du type de ressource personnalisé. Visual C++ met automatiquement en majuscule le nom lorsque vous quittez. Les ressources personnalisées sont uniquement modifiées dans l’éditeur binaire.

Lorsque vous créez une ressource, Visual C++ lui attribue un nom unique, par exemple IDD_Dialog1. Vous pouvez personnaliser cet ID de ressource en modifiant les propriétés de ressource dans l’éditeur de ressources associé ou dans le Fenêtre Propriétés.

Remarque

Ne spécifiez pas de nom de ressource ou d’ID réservé par Visual Studio. Les noms réservés sont DESIGNINFO, HWBet , et TEXTINCLUDEl’ID réservé est 255.

Pour créer une ressource

  • Dans l’affichage des ressources, sélectionnez votre fichier .rc, puis utilisez Modifier une>ressource et choisissez le type de ressource à ajouter à votre projet.

    Conseil

    Vous pouvez également cliquer avec le bouton droit sur le fichier .rc en mode Ressource et choisir Ajouter une ressource dans le menu contextuel.

  • Dans Explorateur de solutions, cliquez avec le bouton droit sur le dossier du projet, sélectionnez Ajouter>une ressource et choisissez le type de ressource à ajouter à votre projet.

    Remarque

    Si vous n’avez pas encore de fichier .rc dans votre projet, cette étape en crée un. Vous pouvez ensuite répéter cette étape pour ajouter des types de ressource spécifiques au nouveau fichier .rc.

  • En mode Classe, cliquez avec le bouton droit sur le projet, sélectionnez Ajouter>une ressource et choisissez le type de ressource à ajouter à votre projet.

  • Utilisez le menu Projet>Ajouter une ressource.

utiliser des modèles de ressources

Un modèle de ressource est une ressource personnalisée que vous avez enregistrée en tant que fichier .rct. Un modèle de ressource sert ensuite de point de départ pour la création de ressources. Les modèles de ressources permettent de gagner du temps dans le développement de ressources supplémentaires ou de groupes de ressources qui partagent des fonctionnalités, telles que des contrôles standard ou des éléments répétés. Par exemple, si vous souhaitez inclure un bouton d’aide avec une icône de logo d’entreprise dans plusieurs boîtes de dialogue, créez un modèle de boîte de dialogue et personnalisez-le avec le bouton d’aide et le logo.

Après avoir personnalisé un modèle de ressource, enregistrez vos modifications dans le dossier du modèle ou l’emplacement spécifié dans le chemin d’accès include, afin que le nouveau modèle de ressource apparaisse sous son type de ressource dans la boîte de dialogue Ajouter une ressource . Vous pouvez maintenant utiliser le nouveau modèle de ressource aussi souvent que nécessaire.

Remarque

L'éditeur de ressources fournit automatiquement un ID de ressource unique. Vous pouvez réviser les propriétés de ressource en fonction des besoins.

Remarque

Placez les fichiers de modèle spécifiques au langage dans les sous-répertoires du répertoire de modèle principal. Par exemple, les fichiers de modèle en anglais uniquement vont dans .. \<resource template directory>\1033.

Visual Studio recherche de nouveaux fichiers .rct dans \Program Files\Microsoft Visual Studio <version>\VC\VCResourceTemplates, \Program Files\Microsoft Visual Studio <version>\VC\VCResourceTemplates\<LCID (par exemple, un LCID> de 1033 pour l’anglais) ou n’importe où sur le chemin d’accès include. Si vous préférez stocker vos fichiers .rct dans un autre emplacement, vous devez ajouter l’emplacement au chemin d’accès include.

Pour créer et utiliser un modèle de ressource

  1. Dans Explorateur de solutions, cliquez avec le bouton droit sur votre projet, puis sélectionnez Ajouter>un nouvel élément.

  2. Dans le volet Modèles, sélectionnez Fichier de modèle de ressource (.rct).

  3. Indiquez un nom et un emplacement pour votre nouveau fichier .rct , puis choisissez Ouvrir.

    Le nouveau fichier .rct est ajouté à votre projet et apparaît dans Explorateur de solutions sous le dossier Ressources.

  4. Double-cliquez sur le fichier .rct pour l’ouvrir dans une fenêtre de document. Pour ajouter des ressources, cliquez avec le bouton droit sur le fichier dans la fenêtre de document, puis choisissez Ajouter une ressource.

    Vous pouvez personnaliser vos ressources ajoutées et enregistrer le fichier .rct .

  5. Dans le volet Affichage des ressources, cliquez avec le bouton droit sur le fichier .rc et choisissez Ajouter une ressource.

  6. Sélectionnez le signe plus (+) en regard d’une ressource pour développer le nœud de ressource et afficher les modèles disponibles pour cette ressource.

  7. Double-cliquez sur le modèle à utiliser.

    Vous pouvez modifier la ressource ajoutée en fonction des besoins dans son éditeur de ressources.

Pour convertir un fichier de ressources existant en modèle

Une fois le fichier de script de ressource ouvert, dans le menu, accédez à Fichier>Enregistrer le <nom de fichier> sous. Spécifiez un emplacement et choisissez OK.

Spécifications

Win32

Voir aussi

Fichiers de ressources
Guide pratique pour gérer les ressources
Guide pratique pour inclure des ressources au moment de la compilation