Cambios en Qt GUI
Qt 6 son el resultado de un esfuerzo deliberado por hacer que el marco sea más eficiente y fácil de usar.
Intentamos mantener la compatibilidad binaria y de código fuente para todas las API públicas en cada versión. Sin embargo, algunos cambios eran inevitables en un esfuerzo por hacer de Qt un marco de trabajo mejor.
En este tema resumimos esos cambios en Qt GUI y ofrecemos orientación para gestionarlos.
Clases del núcleo
La clase QBitmap
Ya no se admite la construcción implícita de un ` QBitmap ` a partir de un ` QPixmap `. El constructor y el operador de asignación se han hecho explícitos y se han marcado como obsoletos. Utiliza en su lugar la nueva función de fábrica estática ` fromPixmap `.
La clase QCursor
Ya no se admite la construcción implícita de un ` QCursor ` a partir de un ` QPixmap `; el constructor se ha convertido en explícito.
La clase QKeyCombination
QKeyCombination es una nueva clase para almacenar una combinación de una tecla con un modificador opcional. Debe utilizarse como sustituto para combinar valores de la enumeración ` Qt::Key ` con un modificador de forma segura en cuanto al tipo.
Recomendamos migrar el código que actualmente utiliza el operador +() para combinar una tecla y modificadores, ya que es probable que los futuros estándares de C++ declaren ilegales las operaciones aritméticas entre tipos de enumeración no relacionados. Utiliza el operador |() y modifica las API que esperan un int para que esperen un QKeyCombination en su lugar.
Las API existentes que esperan un ` int ` para una combinación de claves pueden invocarse utilizando ` QKeyCombination::toCombined()`.
Clases de texto
La clase QFontDatabase
La clase QFontDatabase ahora solo tiene funciones miembro estáticas. El constructor ha quedado obsoleto. En lugar de, por ejemplo:
const QStringList fontFamilies = QFontDatabase().families();utilice
const QStringList fontFamilies = QFontDatabase::families();La clase QFont
Los valores numéricos del enumerador de « QFont::Weight » se han modificado para que se ajusten a los valores de peso de OpenType. La función ` QFont::setWeight()` espera un valor de enumeración en lugar de un ` int`, y el código que llame al setter con un entero no se compilará. Para seguir utilizando los antiguos valores enteros, utilice `QFont::setLegacyWeight()`.
Clases de dibujo
Consulte la guía de adaptación para Qt Print Support para obtener información sobre QPagedPaintDevice y otras clases relacionadas con la impresión.
Clases de utilidad
QIntValidator y QDoubleValidator
El método setRange() ya no está marcado como virtual.
Clases de OpenGL
Con la introducción de Qt RHI como base de renderizado en Qt, la mayoría de las clases con el prefijo QOpenGL se han trasladado al Qt OpenGL módulo.
Se puede encontrar más información en la guía de portabilidad de Qt OpenGL .
Una excepción destacable es la clase QOpenGLContext, que sigue residiendo en Qt GUI.
Además, la clase QOpenGLWidget se ha trasladado a un nuevo módulo, denominado Qt OpenGL Widgets.
La clase QOpenGLContext
La función QOpenGLContext::versionFunctions() se ha sustituido por QOpenGLVersionFunctionsFactory::get(). QOpenGLVersionFunctionsFactory es ahora una clase pública, que forma parte del Qt OpenGL módulo.
ANGLE
En Windows, ANGLE, un traductor de terceros de OpenGL ES a Direct 3D, ya no se incluye en Qt. Esto significa que Qt::AA_UseOpenGLES y la variable de entorno QT_OPENGL=angle ya no tienen ningún efecto. En las compilaciones dinámicas de OpenGL no hay un recurso automático a ANGLE en caso de que OpenGL propiamente dicho falle al inicializarse. Para las aplicaciones basadas en QWindow o QWidget que utilizan OpenGL directamente, por ejemplo a través de QOpenGLWidget, esto significa que OpenGL propiamente dicho es la única opción en tiempo de ejecución. Sin embargo, sigue estando disponible la alternativa de utilizar una implementación de OpenGL puramente de software, como Mesa llvmpipe, que se incluye con los paquetes Qt precompilados. Para las aplicaciones 3D de Qt Quick y Qt Quick, Qt 6 introduce compatibilidad con Direct 3D 11, Vulkan y Metal, además de OpenGL. En Windows, la opción predeterminada es Direct 3D, por lo que la eliminación de ANGLE se ve compensada por la compatibilidad con otras API gráficas además de OpenGL.
Integración nativa del portapapeles
Qt 5 proporcionaba interfaces para integrar formatos de portapapeles específicos de la plataforma o personalizados en Qt a través de QMacPasteboardMime en QtMacExtras y QWindowsMime desde la API QPA de Windows. A partir de Qt 6.6, la funcionalidad equivalente la proporcionan las clases QUtiMimeConverter para macOS y QWindowsMimeConverter para Windows.
La adaptación de QWindowsMime a QWindowsMimeConverter prácticamente no requiere cambios, ya que la interfaz virtual es idéntica. Sin embargo, en Qt 6 ya no es necesario registrar una implementación de QWindowsMimeConverter; al instanciar el tipo, el convertidor se registra de forma implícita.
La adaptación de un `QMacPasteboardMime` a ` QUtiMimeConverter ` requiere renombrar algunas de las funciones virtuales. Tenga en cuenta que la API de ` QMacPasteboardMime ` utilizaba el término obsoleto « flavor » para el formato nativo del portapapeles en macOS, mientras que la plataforma utiliza ahora « Uniform Type Identifiers », es decir, ` UTIs`, lo cual Qt ha adaptado para los nombres de funciones y parámetros.
Las funciones mimeFor y flavorFor se sustituyen por las implementaciones mimeForUti y utiForMime, respectivamente. Estas deberían devolver el nombre del tipo MIME o UTI al que el conversor puede convertir el formato de entrada, por lo que una adaptación suele consistir simplemente en renombrar las sobredeterminaciones existentes. Las funciones convertToMime, convertFromMime y count de QUtiMimeConverter son idénticas a sus versiones de QMacPasteboardMime.
Las funciones canConvert y converterName ya no son necesarias, ya que quedan implícitas en la implementación de las funciones anteriores, por lo que las sobrescrituras de dichas funciones pueden eliminarse.
Al igual que con QWindowsMimeConverter, el registro se realiza instanciando el tipo.
© 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.