<QtGlobal> - Global Qt Declarations
El archivo de encabezado <QtGlobal> incluye una serie de otros archivos de encabezado. Más...
| Header: | #include <QtGlobal> |
Macros
(since 6.8) | QT_ENABLE_STRICT_MODE_UP_TO |
(since 6.0) | QT_NO_FOREACH |
| QT_NO_KEYWORDS |
Descripción detallada
Hasta Qt 6.5, la mayoría de los archivos de encabezado de Qt incluían <QtGlobal>. Antes de Qt 6.5, <QtGlobal> definía una serie de declaraciones globales. La mayoría de ellas se han trasladado, en Qt 6.5, a encabezados independientes, de modo que el código fuente pueda incluir solo lo que necesite, en lugar de toda la colección. Por ahora, <QtGlobal> incluye esos otros archivos de cabecera (véase la siguiente sección), pero es posible que en futuras versiones de Qt se eliminen algunos de estos archivos de <QtGlobal> o que su inclusión dependa de una comprobación de versión. Del mismo modo, en futuras versiones, es posible que algunos archivos de cabecera de Qt que actualmente incluyen <QtGlobal> dejen de hacerlo. Se espera que esto mejore los tiempos de compilación al evitar las declaraciones globales cuando no se utilicen.
Lista de encabezados extraídos de <QtGlobal>
| Cabecera | Resumen |
|---|---|
| <QFlags> | Forma segura en cuanto a tipos de combinar valores de enumeración |
| <QForeach> | Implementación de Qt de los bucles «foreach» y «forever» |
| <QFunctionPointer> | `typedef` para un tipo de puntero a función |
| <QApplicationStatic> | Para Q_APPLICATION_STATIC |
| <QGlobalStatic> | Inicialización segura para subprocesos de objetos estáticos globales |
| <QOverload> | Ayudas para resolver sobrecargas de funciones miembro |
| <QSysInfo> | Una clase auxiliar para obtener información del sistema |
| <QTypeInfo> | Ayudas para obtener información sobre tipos |
| <QtAssert> | Q_ASSERT y otras comprobaciones en tiempo de ejecución |
| <QtClassHelperMacros> | Macros auxiliares de clases de Qt |
| <QtCompilerDetection> | Definiciones de macros específicas del compilador |
| <QtDeprecationMarkers> | Macros auxiliares de obsolescencia |
| <QtEnvironmentVariables> | Ayudas para trabajar con variables de entorno |
| <QtExceptionHandling> | Macros de ayuda para la gestión de excepciones |
| <QtLogging> | Funciones auxiliares de registro de Qt |
| <QtMalloc> | Ayudas para la asignación de memoria |
| <QtMinMax> | Ayudas para comparar valores |
| <QtNumeric> | Diversas funciones numéricas |
| <QtPreprocessorSupport> | Macros de preprocesador auxiliares |
| <QtProcessorDetection> | Definiciones de macros específicas de la arquitectura |
| <QtResource> | Ayudas para la inicialización y limpieza de recursos |
| <QtSwap> | Implementación de ` qSwap()` |
| <QtSystemDetection> | Definiciones de macros específicas de la plataforma |
| <QtTranslation> | Ayudas para la traducción de Qt |
| <QtTypeTraits> | Rasgos de tipos de Qt |
| <QtTypes> | Declaraciones de tipos fundamentales de Qt |
| <QtVersionChecks> | QT_VERSION_CHECK y comprobaciones relacionadas |
| <QtVersion> | QT_VERSION_STR y qVersion() |
Documentación de macros
[since 6.8] QT_ENABLE_STRICT_MODE_UP_TO
Al definir esta macro se desactivarán varias API de Qt que se consideran poco óptimas o peligrosas.
El valor de esta macro debe establecerse en una versión de Qt, utilizando la notación de QT_VERSION_CHECK. Por ejemplo, para establecerla en Qt 6.6, define QT_ENABLE_STRICT_MODE_UP_TO=0x060600. Esto desactivará únicamente las API introducidas en versiones hasta (e incluyendo) la versión de Qt especificada.
Si no se define la macro QT_DISABLE_DEPRECATED_UP_TO, QT_ENABLE_STRICT_MODE_UP_TO también la definirá con el mismo valor.
Esta macro siempre debe establecerse en la versión mínima de Qt que su proyecto desee admitir.
Las API desactivadas por esta macro se enumeran en la tabla siguiente, junto con el valor mínimo que hay que utilizar para desactivarlas.
| Versión | API desactivadas |
|---|---|
| 6.0.0 | foreach (véase QT_NO_FOREACH) |
| 6.0.0 | QString Conversiones a const char * / QByteArray (véase QT_NO_CAST_TO_ASCII) |
| 6.0.0 | QByteArray conversiones implícitas hacia const char * (véase QT_NO_CAST_FROM_BYTEARRAY) |
| 6.0.0 | QUrl Conversiones implícitas desde QString (véase QT_NO_URL_CAST_FROM_STRING) |
| 6.0.0 | Permitir conversiones de restricción en conexiones de señal-ranura (véase QT_NO_NARROWING_CONVERSIONS_IN_CONNECT) |
| 6.0.0 | Iteradores al estilo Java para contenedores Qt |
| 6.6.0 | La función ` qExchange()` (véase QT_NO_QEXCHANGE) |
| 6.7.0 | Sobrecargas de ` QObject::connect ` que no admiten un objeto de contexto (véase QT_NO_CONTEXTLESS_CONNECT) |
| 6.8.0 | La función qAsConst() (véase QT_NO_QASCONST) |
| 6.8.0 | Las funciones open() de las clases de E/S relacionadas con archivos están marcadas como [[nodiscard]] (véase QT_USE_NODISCARD_FILE_OPEN) |
| 6.9.0 | Las funciones qsnprintf() y qvnprintf() (véase QT_NO_QSNPRINTF). |
| 6.12.0 | El alias de tipo « QPair » y la plantilla de función «qMakePair()» (utiliza « std::pair » / «std::make_pair »). |
| 6.12.0 | Ciertas inclusiones transitivas en los encabezados públicos de Qt (incluye tú mismo lo que necesites). |
| 6.12.0 | Compatibilidad con argumentos const QMetaObject::Connection en QObject::disconnect() (véase QT_NO_DISCONNECT_CONST_CONNECTION) |
| 6.12.0 | Compatibilidad con sobrecargas de ` qHash ` sin semilla (véase QT_NO_SINGLE_ARGUMENT_QHASH_OVERLOAD). |
Además, algunas API concretas también pueden desactivarse como parte de la configuración de ` QT_DISABLE_DEPRECATED_UP_TO`. Consulta la documentación de cada clase para obtener más detalles.
Esta macro se introdujo en Qt 6.8.
Véase también QT_DISABLE_DEPRECATED_UP_TO, QT_NO_KEYWORDS y QT_VERSION_CHECK.
[since 6.0] QT_NO_FOREACH
Al definir esta macro, se desactiva el bucle « foreach » de Qt XML.
Esta macro se introdujo en Qt 6.0.
Véase también QT_NO_KEYWORDS.
QT_NO_KEYWORDS
Define esta macro para desactivar las palabras clave específicas de Qt que suelen estar activadas, como signals y slots. Utiliza en su lugar Q_SIGNALS y Q_SLOTS.
Las bibliotecas deben definir esta macro para asegurarse de que no utilizan las palabras clave genéricas sin el prefijo Q_ en sus encabezados públicos.
Véase también QT_NO_FOREACH.
© 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.