<QtDeprecationMarkers> - Qt Deprecation Macros
Die Header-Datei <QtDeprecationMarkers> enthält Hilfsmakros für veraltete Funktionen. Mehr...
| Header: | #include <QtDeprecationMarkers> |
Makros
| QT_DEPRECATED_WARNINGS | |
| QT_DISABLE_DEPRECATED_UP_TO | |
| QT_NO_DEPRECATED_WARNINGS | |
| QT_WARN_DEPRECATED_UP_TO |
Ausführliche Beschreibung
Die Header-Datei deklariert mehrere Makros zum Deaktivieren veralteter Qt-APIs sowie zum Aktivieren bzw. Deaktivieren von Compiler-Warnungen bei deren Verwendung.
Makro-Dokumentation
QT_DEPRECATED_WARNINGS
Seit Qt 5.13 hat dieses Makro keine Wirkung mehr. In Qt 5.12 und früheren Versionen gibt der Compiler, sofern dieses Makro definiert ist, Warnungen aus, wenn eine von Qt als veraltet deklarierte API verwendet wird.
Siehe auch QT_DISABLE_DEPRECATED_UP_TO, QT_NO_DEPRECATED_WARNINGS und QT_WARN_DEPRECATED_UP_TO.
QT_DISABLE_DEPRECATED_UP_TO
Dieses Makro kann in der Projektdatei definiert werden, um Funktionen zu deaktivieren, die in einer bestimmten Version von Qt oder einer früheren Version als veraltet markiert wurden. Die Standardversionsnummer ist 5.0, was bedeutet, dass Funktionen, die in Qt 5.0 oder früheren Versionen als veraltet markiert wurden, nicht einbezogen werden.
Wenn Sie beispielsweise ein Upgrade auf Qt 6.3 vorbereiten, können Sie nach dem Beseitigen aller Veraltungswarnungen „ QT_DISABLE_DEPRECATED_UP_TO=0x060300 “ setzen, um die Qt-APIs, die Sie nicht mehr verwenden, aus Ihren Builds auszuschließen. In der Build-Konfiguration Ihres eigenen Projekts stellt dies sicher, dass jeder, der neue Aufrufe der veralteten APIs hinzufügt, sofort darauf hingewiesen wird. Wenn Sie Qt auch für den Eigenbedarf kompilieren, können Sie durch Einfügen dieser Definition in Ihre Build-Konfiguration für Qt Ihre Binärdateien verkleinern, da dabei sogar die Implementierung der veralteten APIs weggelassen wird.
Hinweis: Um Linker-Fehlerzu vermeiden, sollte in der gesamten Binärdatei durchgehend dieselbe Veralterungsstufe verwendet werden. Das bedeutet, dass bei statischen Builds die Qt-Bibliotheken ebenfalls mit „ QT_DISABLE_DEPRECATED_UP_TO “ auf dieselbe Version gesetzt werden sollten wie im Anwendercode. Der Grund dafür ist, dass bei statischen Builds die Qt-Bibliotheken ebenfalls Teil der Binärdatei werden.
Siehe auch „ QT_DEPRECATED_WARNINGS “ und „ QT_WARN_DEPRECATED_UP_TO “.
QT_NO_DEPRECATED_WARNINGS
Mit diesem Makro lassen sich Verwendungswarnungen unterdrücken, die andernfalls bei der Verwendung veralteter APIs ausgegeben würden.
Siehe auch QT_DISABLE_DEPRECATED_UP_TO und QT_WARN_DEPRECATED_UP_TO.
QT_WARN_DEPRECATED_UP_TO
Dieses Makro kann in der Projektdatei definiert werden, um Verwendungswarnungen zu deaktivieren, die in Qt-Versionen ab der angegebenen Version eingeführt wurden.
Wenn Sie beispielsweise ein Upgrade auf Qt 6.10 vorbereiten und noch nicht bereit sind, sich mit jeder einzelnen Veraltungswarnung auseinanderzusetzen, können Sie „ QT_WARN_DEPRECATED_UP_TO=0x060900 “ so einstellen, dass die Veraltungswarnungen auf diejenigen in Version 6.9 und früher beschränkt werden.
Siehe auch „ QT_DISABLE_DEPRECATED_UP_TO “ und „ 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.