<QtDeprecationMarkers> - Qt Deprecation Macros
Le fichier d'en-tête <QtDeprecationMarkers> contient des macros d'aide à la dépréciation. En savoir plus...
| Header: | #include <QtDeprecationMarkers> |
Macros
| QT_DEPRECATED_WARNINGS | |
| QT_DISABLE_DEPRECATED_UP_TO | |
| QT_NO_DEPRECATED_WARNINGS | |
| QT_WARN_DEPRECATED_UP_TO |
Description détaillée
Ce fichier d'en-tête déclare plusieurs macros permettant de désactiver les API Qt obsolètes et d'activer ou de désactiver les avertissements du compilateur lors de leur utilisation.
Documentation des macros
QT_DEPRECATED_WARNINGS
Depuis Qt 5.13, cette macro n'a plus aucun effet. Dans Qt 5.12 et les versions antérieures, si cette macro est définie, le compilateur génère des avertissements dès lors qu'une API déclarée obsolète par Qt est utilisée.
Voir également QT_DISABLE_DEPRECATED_UP_TO, QT_NO_DEPRECATED_WARNINGS et QT_WARN_DEPRECATED_UP_TO.
QT_DISABLE_DEPRECATED_UP_TO
Cette macro peut être définie dans le fichier de projet pour désactiver les fonctions obsolètes dans une version spécifiée de Qt ou dans toute version antérieure. Le numéro de version par défaut est 5.0, ce qui signifie que les fonctions obsolètes à partir de Qt 5.0 (y compris cette version) ne seront pas incluses.
Par exemple, lorsque vous vous préparez à passer à Qt 6.3, après avoir éliminé tous les avertissements de dépréciation, vous pouvez définir ` QT_DISABLE_DEPRECATED_UP_TO=0x060300 ` pour exclure de vos compilations les API Qt que vous n'utilisez plus. Dans la configuration de compilation de votre propre projet, cela garantira que toute personne ajoutant de nouveaux appels aux API dépréciées en sera immédiatement informée. Si vous compilez également Qt pour votre usage personnel, l’inclusion de cette définition dans votre configuration de compilation pour Qt réduira la taille de vos binaires en omettant même l’implémentation des API obsolètes.
Remarque : afin d’ éviter les erreurs de l’éditeur de liens, le même niveau de dépréciation doit être utilisé de manière cohérente dans l’ensemble du binaire. Cela signifie que, dans les compilations statiques, les bibliothèques Qt doivent également être compilées avec QT_DISABLE_DEPRECATED_UP_TO défini sur la même version que dans le code utilisateur. En effet, dans une compilation statique, les bibliothèques Qt font également partie intégrante du binaire.
Voir également QT_DEPRECATED_WARNINGS et QT_WARN_DEPRECATED_UP_TO.
QT_NO_DEPRECATED_WARNINGS
Cette macro permet de masquer les avertissements de dépréciation qui seraient autrement générés lors de l'utilisation d'API obsolètes.
Voir également QT_DISABLE_DEPRECATED_UP_TO et QT_WARN_DEPRECATED_UP_TO.
QT_WARN_DEPRECATED_UP_TO
Cette macro peut être définie dans le fichier de projet afin de désactiver les avertissements de dépréciation introduits dans les versions de Qt supérieures à la version spécifiée.
Par exemple, lorsque vous vous préparez à passer à Qt 6.10, si vous n'êtes pas prêt à traiter chaque avertissement de dépréciation, vous pouvez définir QT_WARN_DEPRECATED_UP_TO=0x060900 pour limiter les avertissements de dépréciation à ceux de la version 6.9 et des versions antérieures.
Voir également QT_DISABLE_DEPRECATED_UP_TO et QT_NO_DEPRECATED_WARNINGS.
© 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.
