<QtDeprecationMarkers> - Qt Deprecation Macros
El fichero de cabecera <QtDeprecationMarkers> contiene macros de ayuda para la depreciación. Más...
| Header: | #include <QtDeprecationMarkers> |
Macros
| QT_DEPRECATED_WARNINGS | |
| QT_DISABLE_DEPRECATED_UP_TO | |
| QT_NO_DEPRECATED_WARNINGS | |
| QT_WARN_DEPRECATED_UP_TO |
Descripción detallada
El archivo de cabecera declara varias macros para desactivar las APIs Qt obsoletas y activar/desactivar las advertencias del compilador cuando se utilizan.
Documentación de macros
QT_DEPRECATED_WARNINGS
Desde Qt 5.13, esta macro no tiene efecto. En Qt 5.12 y anteriores, si esta macro está definida, el compilador generará advertencias si se utiliza cualquier API declarada como obsoleta por Qt.
Véase también QT_DISABLE_DEPRECATED_UP_TO, QT_NO_DEPRECATED_WARNINGS, y QT_WARN_DEPRECATED_UP_TO.
QT_DISABLE_DEPRECATED_UP_TO
Esta macro puede definirse en el fichero de proyecto para deshabilitar funciones obsoletas en una versión especificada de Qt o cualquier versión anterior. El número de versión por defecto es 5.0, lo que significa que las funciones obsoletas en o antes de Qt 5.0 no se incluirán.
Por ejemplo, cuando te prepares para actualizar a Qt 6.3, después de eliminar todos los avisos de obsoletos, puedes configurar QT_DISABLE_DEPRECATED_UP_TO=0x060300 para excluir de tus compilaciones las APIs de Qt que ya no utilices. En la configuración de compilación de tu propio proyecto, esto asegurará que cualquiera que añada nuevas llamadas a las APIs obsoletas lo sabrá de inmediato. Si también construyes Qt para ti, incluir esta definición en tu configuración de construcción para Qt hará que tus binarios sean más pequeños al dejar fuera incluso la implementación de las APIs obsoletas.
Nota: Para evitar errores del enlazador, debe utilizarse el mismo nivel de obsoleto en todo el binario. Esto significa que en las compilaciones estáticas las librerías Qt también deberían compilarse con QT_DISABLE_DEPRECATED_UP_TO con la misma versión que en el código de usuario. Esto se debe a que en la construcción estática las librerías Qt también se convierten en parte del binario.
Véase también QT_DEPRECATED_WARNINGS y QT_WARN_DEPRECATED_UP_TO.
QT_NO_DEPRECATED_WARNINGS
Esta macro puede utilizarse para suprimir las advertencias de depreciación que de otro modo se generarían al utilizar APIs depreciadas.
Véase también QT_DISABLE_DEPRECATED_UP_TO y QT_WARN_DEPRECATED_UP_TO.
QT_WARN_DEPRECATED_UP_TO
Esta macro puede definirse en el archivo de proyecto para desactivar las advertencias de depreciación introducidas en versiones de Qt superiores a la versión especificada.
Por ejemplo, cuando se prepara la actualización a Qt 6.10, si no se está preparado para lidiar con todos y cada uno de los avisos de desaprobación, se puede definir QT_WARN_DEPRECATED_UP_TO=0x060900 para limitar los avisos de desaprobación a los de la versión 6.9 y anteriores.
Véase también QT_DISABLE_DEPRECATED_UP_TO y 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.
