<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, 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 veraltet sind. Die Standardversionsnummer ist 5.0, was bedeutet, dass Funktionen, die in oder vor Qt 5.0 veraltet sind, nicht enthalten sind.

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, können Sie durch die Aufnahme dieser Definition in Ihre Build-Konfiguration für Qt Ihre Binärdateien verkleinern, indem Sie sogar die Implementierung der veralteten APIs weglassen.

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 der Binärdatei werden.

Siehe auch QT_DEPRECATED_WARNINGS und QT_WARN_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 und QT_WARN_DEPRECATED_UP_TO.

QT_WARN_DEPRECATED_UP_TO

Dieses Makro kann in der Projektdatei definiert werden, um Verfallswarnungen zu deaktivieren, die in höheren Qt-Versionen als der angegebenen Version eingeführt wurden.

Wenn Sie beispielsweise bei der Vorbereitung eines Upgrades auf Qt 6.10 nicht bereit sind, sich mit jeder einzelnen Verwerfungswarnung zu befassen, können Sie QT_WARN_DEPRECATED_UP_TO=0x060900 so einstellen, dass die Verwerfungswarnungen auf diejenigen in 6.9 und früher beschränkt werden.

Siehe auch QT_DISABLE_DEPRECATED_UP_TO und QT_NO_DEPRECATED_WARNINGS.

© 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.