<QtDeprecationMarkers> - Qt Deprecation Macros

El archivo de cabecera <QtDeprecationMarkers> contiene macros de ayuda para la obsolescencia. Más información...

Header: #include <QtDeprecationMarkers>

Macros

Descripción detallada

El archivo de cabecera declara varias macros para desactivar las API de Qt en desuso y para activar o desactivar las advertencias del compilador cuando se utilizan.

Documentación de las macros

QT_DEPRECATED_WARNINGS

Desde Qt 5.13, esta macro no tiene ningún efecto. En Qt 5.12 y versiones anteriores, si se define esta macro, el compilador generará advertencias si se utiliza alguna 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 se puede definir en el archivo de proyecto para desactivar las funciones obsoletas en una versión específica de Qt o en cualquier versión anterior. El número de versión predeterminado es 5.0, lo que significa que no se incluirán las funciones obsoletas en Qt 5.0 o en versiones anteriores.

Por ejemplo, al prepararte para actualizar a Qt 6.3, tras eliminar todas las advertencias de obsolescencia, puedes establecer ` QT_DISABLE_DEPRECATED_UP_TO=0x060300 ` para excluir de tus compilaciones las API de Qt que ya no utilices. En la configuración de compilación de tu propio proyecto, esto garantizará que cualquiera que añada nuevas llamadas a las API obsoletas se dé cuenta de ello de inmediato. Si además compilas Qt para tu propio uso, incluir esta definición en la configuración de compilación de Qt reducirá el tamaño de tus binarios, ya que se omitirá incluso la implementación de las API obsoletas.

Nota: Para evitar errores del enlazador, debe utilizarse el mismo nivel de obsolescencia de forma coherente en todo el binario. Esto significa que, en las compilaciones estáticas, las bibliotecas de Qt también deben compilarse con QT_DISABLE_DEPRECATED_UP_TO establecido en la misma versión que en el código de usuario. Esto se debe a que, en una compilación estática, las bibliotecas de Qt también pasan a formar parte del binario.

Véase también QT_DEPRECATED_WARNINGS y QT_WARN_DEPRECATED_UP_TO.

QT_NO_DEPRECATED_WARNINGS

Esta macro se puede utilizar para suprimir las advertencias de obsolescencia que, de otro modo, se generarían al utilizar API obsoletas.

Véase también QT_DISABLE_DEPRECATED_UP_TO y QT_WARN_DEPRECATED_UP_TO.

QT_WARN_DEPRECATED_UP_TO

Esta macro se puede definir en el archivo de proyecto para desactivar las advertencias de funciones obsoletas introducidas en versiones de Qt superiores a la especificada.

Por ejemplo, al prepararse para actualizar a Qt 6.10, si no estás preparado para gestionar todas y cada una de las advertencias de obsolescencia, puedes configurar QT_WARN_DEPRECATED_UP_TO=0x060900 para limitar las advertencias de obsolescencia a las 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.