<QtDeprecationMarkers> - Qt Deprecation Macros
Die <QtDeprecationMarkers> Header-Datei enthält Hilfsmakros für die Verwerfung. Mehr...
| Header: | #include <QtDeprecationMarkers> |
Makros
Detaillierte Beschreibung
Die Header-Datei deklariert mehrere Makros zum Deaktivieren veralteter Qt-APIs und zum Aktivieren/Deaktivieren von Compiler-Warnungen, wenn sie verwendet werden.
Makro-Dokumentation
QT_DEPRECATED_WARNINGS
Seit Qt 5.13 hat dieses Makro keine Wirkung mehr. In Qt 5.12 und davor, wenn dieses Makro definiert ist, erzeugt der Compiler Warnungen, wenn eine von Qt als veraltet deklarierte API verwendet wird.
Siehe auch QT_DISABLE_DEPRECATED_UP_TO und QT_NO_DEPRECATED_WARNINGS.
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 veraltet sind. Die Standardversionsnummer ist 5.0, was bedeutet, dass Funktionen, die in oder vor Qt 5.0 veraltet sind, nicht einbezogen werden.
Wenn Sie z.B. ein Upgrade auf Qt 6.3 vorbereiten, können Sie, nachdem Sie alle Verwerfungswarnungen beseitigt haben, QT_DISABLE_DEPRECATED_UP_TO=0x060300 so einstellen, dass die Qt-APIs, die Sie nicht mehr verwenden, von Ihren Builds ausgeschlossen werden. In der Build-Konfiguration Ihres eigenen Projekts stellt dies sicher, dass jeder, der neue Aufrufe zu den veralteten APIs hinzufügt, sofort davon erfährt. Wenn Sie Qt auch für sich selbst bauen, wird die Aufnahme dieser Definition in Ihre Build-Konfiguration für Qt Ihre Binärdateien verkleinern, indem sogar die Implementierung der veralteten APIs weggelassen wird.
Hinweis: Um Linker-Fehler zu vermeiden, sollte die gleiche Verwerfungsstufe konsistent in der gesamten Binärdatei verwendet werden. Das bedeutet, dass bei statischen Builds die Qt-Bibliotheken ebenfalls mit QT_DISABLE_DEPRECATED_UP_TO auf dieselbe Version wie im Anwendercode gesetzt werden sollten. Das liegt daran, dass bei statischen Builds die Qt-Bibliotheken auch ein Teil des Binarys werden.
Siehe auch QT_DEPRECATED_WARNINGS und QT_DISABLE_DEPRECATED_UP_TO.
QT_NO_DEPRECATED_WARNINGS
Dieses Makro kann zur Unterdrückung von Verwerfungswarnungen verwendet werden, die andernfalls bei der Verwendung veralteter APIs erzeugt werden würden.
Siehe auch QT_DISABLE_DEPRECATED_UP_TO.
© 2025 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.
