<QtDeprecationMarkers> - Qt Deprecation Macros
Le fichier d'en-tête <QtDeprecationMarkers> contient des macros d'aide à la dépréciation. Plus d'informations...
| 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
Le fichier d'en-tête déclare plusieurs macros pour désactiver les API Qt dépréciées et activer/désactiver les avertissements du compilateur lorsqu'elles sont utilisées.
Documentation des macros
QT_DEPRECATED_WARNINGS
Depuis Qt 5.13, cette macro n'a plus d'effet. Dans Qt 5.12 et avant, si cette macro est définie, le compilateur génère des avertissements si une API déclarée comme dépréciée par Qt est utilisée.
Voir aussi 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 toute version antérieure. Le numéro de version par défaut est 5.0, ce qui signifie que les fonctions obsolètes dans ou avant Qt 5.0 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 configurer QT_DISABLE_DEPRECATED_UP_TO=0x060300 pour exclure de vos constructions les API de Qt que vous n'utilisez plus. Dans la configuration de construction de votre propre projet, cela garantira que toute personne ajoutant de nouveaux appels aux API dépréciées le saura immédiatement. Si vous construisez également Qt pour vous-même, l'inclusion de cette définition dans votre configuration de construction pour Qt rendra vos binaires plus petits en laissant de côté même l'implémentation des APIs dépréciées.
Note : Afin d'éviter les erreurs d'édition 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 constructions statiques, les bibliothèques Qt doivent également être construites avec QT_DISABLE_DEPRECATED_UP_TO réglé sur la même version que dans le code utilisateur. En effet, lors de la compilation statique, les bibliothèques Qt font également partie du binaire.
Voir aussi QT_DEPRECATED_WARNINGS et QT_WARN_DEPRECATED_UP_TO.
QT_NO_DEPRECATED_WARNINGS
Cette macro peut être utilisée pour supprimer les avertissements de dépréciation qui seraient autrement générés lors de l'utilisation d'API dépréciées.
Voir aussi 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 pour 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 à gérer tous les avertissements 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 aussi 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.
