Fichiers de ressources (C++)

Article
10/12/2023

Remarque

Comme les projets écrits dans les langages de programmation .NET managés n’utilisent pas de fichiers de script de ressources, vous devez ouvrir vos ressources à partir de l’ Explorateur de solutions. Utilisez l’éditeur d’images et l’éditeur binaire pour utiliser des fichiers de ressources dans des projets gérés.

Toutes les ressources managées que vous souhaitez modifier doivent être liées. Les éditeurs de ressources Visual Studio ne prennent pas en charge la modification des ressources incorporées.

Le fichier de ressources peut faire référence à l’un des types de fichiers suivants :

Fichier de script de ressources (.rc) d’un programme.
Fichier de modèle de ressource (.rct).
Ressource individuelle existante en tant que fichier autonome. Ce type inclut un fichier bitmap, icône ou curseur référencé à partir d’un .rc fichier.
Fichier d’en-tête généré par l’environnement de développement. Ce type inclut Resource.h, qui est référencé à partir d’un .rc fichier.

D’autres types de fichiers tels que .exe, .dllet .res les fichiers peuvent également contenir des ressources auxquelles vous pouvez accéder, bien que les deux premiers ne soient pas normalement considérés comme des fichiers de ressources.

Vous pouvez utiliser des fichiers de ressources et des ressources à partir de votre projet. Vous pouvez également utiliser des ressources et des fichiers de ressources qui ne font pas partie du projet actuel ou qui ont été créés en dehors de l’environnement de développement de Visual Studio. Par exemple, vous pouvez :

Travailler avec des fichiers de ressources imbriqués et inclus de manière conditionnelle
Mettez à jour les ressources existantes ou convertissez-les en Visual C++.
Importer ou exporter des ressources graphiques vers ou à partir de votre fichier de ressources actif
Inclure des identificateurs partagés ou en lecture seule (symboles) qui ne peuvent pas être modifiés par l’environnement de développement
Incluez des ressources dans votre fichier exécutable (.exe ou .dll) qui n’ont pas besoin de modification (ou ne doivent pas être modifiées), telles que les ressources partagées entre plusieurs projets.
Inclure des types de ressources non pris en charge par l’environnement de développement

Pour plus d’informations sur les ressources, consultez comment créer des ressources, gérer des ressources et inclure des ressources au moment de la compilation.

Ressources modifiables

Les types de fichiers suivants peuvent être ouverts pour modifier les ressources qu’ils contiennent :

Nom de fichier	Description
`.rc`	Fichiers de script de ressources
`.rct`	Fichiers de modèle de ressources
`.res`	Fichiers de ressources
`.resx`	Fichiers de ressources managés
`.exe`	Fichiers exécutables
`.dll`	Fichiers de bibliothèque de liens dynamiques
`.bmp`, `.ico`, `.dib`, `.cur`	Fichiers bitmap, icône, barre d’outils et curseurs

L’environnement Visual Studio fonctionne avec et affecte les fichiers suivants lors de la modification des ressources :

Nom de fichier	Description
`Resource.h`	Fichier d’en-tête généré par l’environnement de développement qui contient des définitions de symboles. Incluez ce fichier dans le contrôle de code source.
`Filename.aps`	Version binaire du fichier de script de ressources actuel utilisé pour le chargement rapide. Les éditeurs de ressources ne lisent pas directement ou ne lisent `.rc` pas les fichiers resource.h. Le compilateur de ressources les compile dans `.aps` des fichiers qui sont consommés par les éditeurs de ressources. Ce fichier est une étape de compilation, qui stocke uniquement les données symboliques. Comme avec un processus de compilation normal, les informations qui ne sont pas symboliques, telles que les commentaires, sont dis carte ed pendant le processus de compilation. Chaque fois que le `.aps` fichier n’est pas synchronisé avec le `.rc` fichier, le `.rc` fichier est régénéré. Par exemple, lorsque vous enregistrez, l’éditeur de ressources remplace le `.rc` fichier et le `resource.h` fichier. Toutes les modifications apportées aux ressources elles-mêmes restent incorporées dans le `.rc` fichier, mais les commentaires sont toujours perdus une fois le `.rc` fichier remplacé. Pour plus d’informations sur la conservation des commentaires, consultez Inclure des ressources au moment de la compilation. En règle générale, vous ne devez pas inclure le fichier dans le `.aps` contrôle de code source.
`.rc`	Fichier de script de ressources qui contient le script des ressources de votre projet actif. Ce fichier est remplacé par le `.aps` fichier chaque fois que vous enregistrez. Incluez ce fichier dans le contrôle de code source.

Ressources de manifeste

Dans les projets de bureau C++, les ressources de manifeste sont des fichiers XML qui décrivent les dépendances qu’une application utilise. Par exemple, dans Visual Studio, ce fichier manifeste généré par l’Assistant MFC définit la version des DLL de contrôle commun Windows que l’application doit utiliser :

<description>Your app description here</description>
<dependency>
    <dependentAssembly>
        <assemblyIdentity
            type="win32"
            name="Microsoft.Windows.Common-Controls"
            version="6.0.0.0"
            processorArchitecture="X86"
            publicKeyToken="6595b64144ccf1df"
            language="*"
        />
    </dependentAssembly>
</dependency>

Pour une application Windows XP ou Windows Vista, la ressource de manifeste doit spécifier la version la plus récente des contrôles courants Windows que l’application doit utiliser. L’exemple ci-dessus utilise la version 6.0.0.0, qui prend en charge le Syslink contrôle.

Remarque

Vous ne pouvez avoir qu'une seule ressource de manifeste par module.

Pour afficher les informations de version et de type contenues dans une ressource de manifeste, ouvrez le fichier dans une visionneuse XML ou l’éditeur de texte Visual Studio. Si vous ouvrez une ressource de manifeste à partir de la fenêtre Affichage des ressources, la ressource s'ouvre au format binaire.

Pour ouvrir une ressource de manifeste

Ouvrez votre projet dans Visual Studio et accédez à Explorateur de solutions.
Développez le dossier Fichiers de ressources, puis :
- Pour ouvrir dans l’éditeur de texte, double-cliquez sur le .manifest fichier.
- Pour ouvrir dans un autre éditeur, cliquez avec le bouton droit sur le .manifest fichier, puis sélectionnez Ouvrir avec. Spécifiez l’éditeur à utiliser et sélectionnez Ouvrir.

Spécifications

Win32

Voir aussi

Utilisation des fichiers de ressources
Identificateurs de ressource (symboles)
Éditeurs de ressources