TN023 : ressources MFC standard
Cette note décrit les ressources standard fournies et requises par la bibliothèque MFC.
Ressources standard
MFC propose deux catégories de ressources prédéfinies que vous pouvez utiliser dans votre application : ressources image clipart et ressources framework standard.
Les ressources image clipart sont des ressources supplémentaires auxquelles le framework ne dépend, mais que vous pouvez souhaiter ajouter à l'interface utilisateur de l'application. Les ressources clipart suivantes sont contenues dans l’exemple CLIPART général MFC :
Common.rc : un seul fichier de ressources qui contient :
Une grande collection d’icônes qui représentent une variété de tâches d’entreprise et de traitement de données.
Plusieurs curseurs communs (voir aussi l'Afxres.rc).
Bitmap de la barre d'outils qui contient plusieurs boutons de la barre d'outils.
Ressources bitmap et icône utilisées par Commdlg.dll.
Indicate.rc : contient des ressources de chaîne pour les indicateurs d'état du bouton de la barre d'état, tels que "CAP" pour les Majuscules.
Prompts.rc : contient des ressources de chaîne d’invite de menus pour chaque commande prédéfinie, par exemple « Créer un document » pour ID_FILE_NEW.
Commdlg.rc : fichier .rc compatible Visual C++ qui contient les modèles de la boîte de dialogue COMMDLG standard.
Les ressources framework standard sont des ressources avec des ID AFX auxquelles le framework dépend pour les implémentations internes. Vous devez fréquemment modifier ces ressources AFX. Dans ce cas, vous devrez suivre la procédure dont les grandes lignes sont présentées plus loin dans cette rubrique.
Les ressources framework suivantes sont contenues dans le répertoire MFC\INCLUDE :
Afxres.rc : ressources communes utilisées par le framework.
Afxprint.rc : ressources spécifiques à l'impression.
Afxolecl.rc : ressources spécifiques aux applications clientes OLE.
Afxolev.rc : ressources spécifiques aux applications serveur OLE complètes.
Utilisation des ressources image clipart
Pour utiliser une ressource binaire d'image clipart
Ouvrez le fichier des ressources de votre application dans Visual C++.
Ouvrez Common.rc. Ce fichier contient toutes les ressources d'image clipart binaires. Cette opération peut prendre quelque temps car le fichier Common.rc est compilé.
Maintenez la touche CTRL enfoncée pendant que vous faites glisser les ressources à utiliser dans Common.rc vers le fichier des ressources de votre application.
Pour utiliser d'autres ressources image clipart, suivez les mêmes étapes. La seule différence est que vous ouvrirez le fichier .rc approprié au lieu du fichier Common.rc.
Remarque
Faites attention de ne pas déplacer involontairement des ressources en dehors du fichier Common.rc de manière irréversible. Si vous maintenez la touche CTRL enfoncée pendant que vous faites glisser des ressources, vous allez créer une copie. Si vous ne conservez pas la touche CTRL enfoncée pendant que vous effectuez le déplacement des éléments, les ressources seront déplacées. Si vous avez modifié le fichier Common.rc par inadvertance, cliquez sur "Non" lorsque vous êtes invité à enregistrer les modifications apportées au fichier Common.rc.
Remarque
Les fichiers de ressources .rc ont une ressource TEXTINCLUDE spéciale qui vous empêchera d’enregistrer accidentellement les fichiers .rc standard.
Personnalisation des ressources framework standard
Les ressources framework standard sont généralement incluses dans une application avec la commande #include dans le fichier de ressources d'une application. AppWizard génère un fichier de ressources. Ce fichier contient les ressources framework standard adéquates, en fonction des options AppWizard que vous sélectionnez. Vous pouvez examiner, ajouter ou supprimer les ressources incluses en modifiant les directives au moment de la compilation. Pour ce faire, ouvrez le menu Ressource et sélectionnez Définir les éléments inclus. Recherchez l'élément de modification "Compile-Time Directives". Par exemple :
#include "afxres.rc"
#include "afxprint.rc"
Le cas le plus fréquent de personnalisation des ressources framework standard est l'ajout ou la suppression des inclusions supplémentaires pour l'impression, le client OLE et la prise en charge du serveur OLE.
Dans certains cas exceptionnels, vous pouvez personnaliser le contenu des ressources framework standard pour votre application spécifique, pas seulement pour ajouter et supprimer le fichier complet. Les étapes suivantes montrent comment vous pouvez limiter les ressources qui sont incluses :
Pour personnaliser le contenu d'un fichier de ressources standard
Ouvrez le fichier de ressources dans Visual C++.
Lors de l'utilisation de la commande Set Includes relative aux ressources, supprimez
#includedans le fichier standard .rc que vous souhaitez personnaliser. Par exemple, pour personnaliser la barre d'outils d'aperçu avant impression, supprimez la ligne#include "afxprint.rc".Ouvrez les fichiers de ressources standard appropriés dans MFC\INCLUDE. Suite au dernier exemple de cette rubrique, le fichier approprié est MFC\Include\Aafxprint.rc
Copiez toutes les ressources du fichier .rc standard dans votre fichier de ressources d'application.
Modifiez la copie des ressources standard dans votre fichier de ressources d'application.
Remarque
Ne modifiez pas les ressources directement dans les fichiers .rc standard. Ce qui modifie les ressources disponibles dans chaque application, et non dans celle sur laquelle vous travaillez actuellement.