Cambios en los módulos Qt Extras
Qt 6 es el resultado de un esfuerzo deliberado por hacer que el marco de trabajo 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.
Uno de esos cambios fue la eliminación de los módulos «Extras» específicos de cada plataforma, con el fin de garantizar una experiencia multiplataforma coherente y un futuro prometedor para Qt 6. La mayor parte de la funcionalidad que ofrecían estos módulos ha sido sustituida por una funcionalidad similar en otros módulos de Qt. Esta guía resume dichas alternativas y ofrece orientación para los casos en los que Qt no ofrece una API sustitutiva.
Cambios en Qt Mac Extras
Espacio de nombres QtMac
La mayoría de los elementos del espacio de nombres QtMac tienen sustitutos explícitos. Se ha eliminado la función QtMac::fromCGImageRef debido a la falta de clientes conocidos de la API.
QMacPasteboardMime
La clase QMacPasteboardMime ha sido sustituida por QUtiMimeConverter. Para más detalles, consulta «Cambios en Qt GUI#Integración nativa del portapapeles ».
QMacToolBar
Se han eliminado las clases QMacToolBar y QMacToolBarItem. Utiliza QToolBar como sustituto.
Cambios en Qt Windows Extras
Espacio de nombres QtWin
Muchos miembros del espacio de nombres QtWin tienen sustitutos explícitos. Para utilizar estos sustitutos con Qt Widgets o Qt Quick, opera sobre la representación QWindow del widget o control correspondiente.
Las funciones restantes se han eliminado:
errorStringFromHresult
Solo se utiliza internamente en WinExtras. No se conocen otros clientes de la API.
colorizationColor/isCompositionOpaque
El concepto existe en otras plataformas (tint/accent color). Justifica una nueva API multiplataforma, por ejemplo, una nueva función de QPalette o una propiedad de tema de la plataforma.
setWindowFlip3DPolicy
Función de Windows 7. Ya no es compatible con Windows 10.
extendFrameIntoClientArea
Existe una funcionalidad similar en otras plataformas. Justifica una API multiplataforma de « QWindow » para controlar la relación entre el área de cliente y el área que no es de cliente (marco/barra de título). Véase QTBUG-94010 para más detalles.
enableBlurBehind
Obsoleta a partir de Windows 8.
taskbarActivateTab y taskbar(Add/Delete)Tab
No se conocen clientes de esta API.
QWinMime
La clase QWinMime ha sido sustituida por QWindowsMimeConverter. Para más detalles, consulta «Cambios en Qt GUI » en el apartado «Integración nativa del portapapeles ».
QWinJumpList
Se han eliminado las clases QWinJumpList, QWinJumpListCategory y QWinJumpListItem debido a la necesidad de una solución multiplataforma. Consulte QTBUG-94007 para obtener más detalles.
QWinTaskbarButton
Se han eliminado las clases QWinTaskbarButton y QWinTaskbarProgress para dar paso a una solución multiplataforma. Consulte QTBUG-94009 y QTBUG-94008 para obtener más detalles.
QWinThumbnailToolBar
Se han eliminado las clases QWinThumbnailToolBar y QWinThumbnailToolButton debido a la falta de clientes conocidos de la API.
Cambios en Qt X11 Extras
El módulo Qt X11 Extras se ha eliminado en Qt 6.
- Para QX11Info::connection(), utilice en su lugar QNativeInterface::QX11Application::connection().
- Para QX11Info::display(), utilice en su lugar QNativeInterface::QX11Application::display().
- Para QX11Info::isPlatformX11(), comprueba en su lugar si existe QNativeInterface::QX11Application.
Asegúrate de comprobar que puedes obtener un objeto ` QNativeInterface::QX11Application ` desde ` QGuiApplication`, tal y como se muestra en el siguiente fragmento de código:
Display *display = nullptr;
xcb_connection_t *connection = nullptr;
bool isPlatformX11 = false;
if (auto *x11Application = qGuiApp->nativeInterface<QNativeInterface::QX11Application>()) {
display = x11Application->display();
connection = x11Application->connection();
isPlatformX11 = true;
}
// or
// isPlatformX11 = qGuiApp->nativeInterface<QNativeInterface::QX11Application>();Los clientes que sigan dependiendo de la funcionalidad de la clase QX11Info pueden incluir el encabezado privado <QtGui/private/qtx11extras_p.h> como solución provisional. Para habilitar los encabezados privados, utiliza QT += gui-private junto con qmake, o añade una dependencia del proyecto a Qt::GuiPrivate con CMake.
Cambios en Qt for Android Extras
Las funcionalidades clave del módulo se han trasladado a otros módulos de Qt.
Los clientes que aún dependan de funcionalidades que faltan pueden incluir el encabezado privado <QtCore/private/qandroidextras_p.h> como solución provisional. Para habilitar los encabezados privados, utilice QT += core-private con qmake, o añada una dependencia del proyecto a Qt::CorePrivate con CMake.
QAndroidJniObject y QAndroidJniEnvironment
Las clases QAndroidJniObject y QAndroidJniEnvironment han sido sustituidas por QJniObject y QJniEnvironment, respectivamente.
La clase QAndroidJniExceptionCleaner ya no es necesaria. Consulte QJniEnvironment::checkAndClearExceptions() para ver su sustituto.
Espacio de nombres QtAndroid
Muchos elementos del espacio de nombres QtAndroid tienen sustitutos en la interfaz nativa QAndroidApplication.
Permisos
La infraestructura de permisos de la aplicación permite solicitar un conjunto de permisos de forma multiplataforma.
El espacio de nombres QtAndroidPrivate se puede utilizar para acceder a permisos específicos de Android que no están cubiertos por el sistema de permisos multiplataforma.
© 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.