<QtDeprecationMarkers> - Qt Deprecation Macros

The <QtDeprecationMarkers> header file contains deprecation helper macros. More...

Header: #include <QtDeprecationMarkers>

Macros

Detailed Description

The header file declares several macros for disabling deprecated Qt APIs and enabling/disabling compiler warnings when they are used.

Macro Documentation

QT_DEPRECATED_WARNINGS

Since Qt 5.13, this macro has no effect. In Qt 5.12 and before, if this macro is defined, the compiler will generate warnings if any API declared as deprecated by Qt is used.

See also QT_DISABLE_DEPRECATED_UP_TO and QT_NO_DEPRECATED_WARNINGS.

QT_DISABLE_DEPRECATED_UP_TO

This macro can be defined in the project file to disable functions deprecated in a specified version of Qt or any earlier version. The default version number is 5.0, meaning that functions deprecated in or before Qt 5.0 will not be included.

For instance, when preparing to upgrade to Qt 6.3, after eliminating all deprecation warnings, you can set QT_DISABLE_DEPRECATED_UP_TO=0x060300 to exclude from your builds the Qt APIs you no longer use. In your own project's build configuration, this will ensure that anyone adding new calls to the deprecated APIs will know about it right away. If you also build Qt for yourself, including this define in your build configuration for Qt will make your binaries smaller by leaving out even the implementation of the deprecated APIs.

See also QT_DEPRECATED_WARNINGS and QT_DISABLE_DEPRECATED_UP_TO.

QT_NO_DEPRECATED_WARNINGS

This macro can be used to suppress deprecation warnings that would otherwise be generated when using deprecated APIs.

See also QT_DISABLE_DEPRECATED_UP_TO.