<QtResource>

Macros permettant de gérer le système de ressources Qt. En savoir plus…

Header: #include <QtResource>

Macros

void Q_CLEANUP_RESOURCE(name)
void Q_INIT_RESOURCE(name)

Description détaillée

Documentation sur les macros

void Q_CLEANUP_RESOURCE(name)

Décharge les ressources spécifiées dans le fichier « .qrc » dont le nom de base est « name ».

Normalement, les ressources Qt sont déchargées automatiquement à la fermeture de l'application, mais si les ressources se trouvent dans un plugin en cours de déchargement, appelez Q_CLEANUP_RESOURCE() pour forcer la suppression de vos ressources.

Remarque : cette macro ne peut pas être utilisée dans un espace de noms. Veuillez consulter la documentation d'Q_INIT_RESOURCE pour connaître une solution de contournement.

Exemple :

Q_CLEANUP_RESOURCE(myapp);

Voir également ` Q_INIT_RESOURCE()` et « Le système de ressources Qt ».

void Q_INIT_RESOURCE(name)

Initialise les ressources spécifiées dans le fichier .qrc à l'aide de l'name de base indiquée. En règle générale, lorsque les ressources sont intégrées à l'application lors de sa compilation, elles sont chargées automatiquement au démarrage. La macro Q_INIT_RESOURCE() est nécessaire sur certaines plateformes pour les ressources stockées dans une bibliothèque statique.

Par exemple, si les ressources de votre application sont répertoriées dans un fichier nommé myapp.qrc, vous pouvez vous assurer qu'elles sont initialisées au démarrage en ajoutant cette ligne à votre fonction main():

Q_INIT_RESOURCE(myapp);

Si le nom du fichier contient des caractères qui ne peuvent pas faire partie d’un nom de fonction C++ valide (tels que « - »), ceux-ci doivent être remplacés par le caractère de soulignement (« _ »).

Remarque : cette macro ne peut pas être utilisée dans un espace de noms. Elle doit être appelée depuis la fonction `main()`. Si cela n'est pas possible, la solution de contournement suivante peut être utilisée pour initialiser la ressource ` myapp ` depuis la fonction ` MyNamespace::myFunction` :

inline void initMyResource() { Q_INIT_RESOURCE(myapp); }

namespace MyNamespace
{
    //...

    void myFunction()
    {
        initMyResource();
    }
}

Voir également ` Q_CLEANUP_RESOURCE()` et « Le système de ressources Qt ».

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.