<QtDeprecationMarkers> - Qt Deprecation Macros

宏文档

QT_DEPRECATED_WARNINGS

自 Qt 5.13 起，此宏不再起作用。在 Qt 5.12 及更早版本中，如果定义了此宏，当使用任何被 Qt 声明为已弃用的 API 时，编译器会生成警告。

另请参阅 QT_DISABLE_DEPRECATED_UP_TO 、QT_NO_DEPRECATED_WARNINGS 以及QT_WARN_DEPRECATED_UP_TO 。

QT_DISABLE_DEPRECATED_UP_TO

可以在项目文件中定义此宏，以禁用在指定版本的 Qt 或任何更早版本中已弃用的函数。默认版本号为 5.0，这意味着 Qt 5.0 及更早版本中已弃用的函数将不会被包含。

例如，在准备升级到 Qt 6.3 时，清除所有弃用警告后，您可以设置 `QT_DISABLE_DEPRECATED_UP_TO=0x060300 `，从而在构建中排除不再使用的 Qt API。在您自己的项目构建配置中，这将确保任何向已弃用的 API 添加新调用的人都能立即意识到这一点。 如果您还为自己构建 Qt，在 Qt 的构建配置中包含此定义将排除已弃用的 API 实现，从而使二进制文件更小。

另请参阅 QT_DEPRECATED_WARNINGS 和QT_WARN_DEPRECATED_UP_TO 。

QT_NO_DEPRECATED_WARNINGS

此宏可用于抑制在使用已弃用 API 时本会生成的弃用警告。

另请参阅 QT_DISABLE_DEPRECATED_UP_TO 和QT_WARN_DEPRECATED_UP_TO 。

QT_WARN_DEPRECATED_UP_TO

可以在项目文件中定义此宏，以禁用在高于指定版本的 Qt 版本中引入的弃用警告。

例如，在准备升级到 Qt 6.10 时，若您尚未准备好处理每一条弃用警告，可以将 `QT_WARN_DEPRECATED_UP_TO=0x060900 ` 设置为仅显示 Qt 6.9 及更早版本中的弃用警告。

另请参阅 QT_DISABLE_DEPRECATED_UP_TO 和QT_NO_DEPRECATED_WARNINGS 。