Cambios en los módulos extras de Qt

Qt 6 es el resultado del esfuerzo consciente por hacer el framework más eficiente y fácil de usar.

Intentamos mantener la compatibilidad binaria y de código fuente de todas las API públicas en cada versión. Pero algunos cambios eran inevitables en un esfuerzo por hacer de Qt un framework mejor.

Uno de esos cambios fue eliminar los módulos Extras específicos de cada plataforma, para garantizar una historia y un futuro cohesivos y multiplataforma para Qt 6. La mayor parte de la funcionalidad ofrecida por estos módulos se sustituye por una funcionalidad similar en otros módulos de Qt. Esta guía resume esas alternativas, y proporciona orientación para los casos en los que Qt no ofrece una API de reemplazo.

Cambios en Qt Mac Extras

Espacio de nombres QtMac

La mayoría de los miembros del espacio de nombres QtMac tienen sustitutos explícitos. La función QtMac::fromCGImageRef ha sido eliminada debido a la falta de clientes conocidos de la API.

QMacPasteboardMime

La clase QMacPasteboardMime ha sido reemplazada por QUtiMimeConverter. Ver Cambios en Qt GUI#Integración nativa del portapapeles para más detalles.

QMacToolBar

Las clases QMacToolBar y QMacToolBarItem han sido eliminadas. Utilice QToolBar como reemplazo.

Cambios en Qt Windows Extras

Espacio de nombres QtWin

Muchos miembros del espacio de nombres QtWin tienen reemplazos explícitos. Para usar estos reemplazos con Qt Widgets o Qt Quick, opere sobre la representación QWindow del widget o control relevante.

Las funciones restantes han sido eliminadas:

errorStringFromHresult

Sólo se utiliza internamente en WinExtras. No se conocen otros clientes de la API.

colorizationColor/isCompositionOpaque

El concepto existe en otras plataformas (tint/accent color). Garantiza una nueva API multiplataforma, por ejemplo un nuevo rol QPalette o una propiedad de tema de plataforma.

setWindowFlip3DPolicy

Característica de Windows 7. Ya no es compatible con Windows 10.

extendFrameIntoClientArea

Existe una funcionalidad similar en otras plataformas. Garantiza la API QWindow multiplataforma para controlar la relación entre el área cliente y el área no cliente (marco/titlebar). Ver QTBUG-94010 para más detalles.

enableBlurBehind

Obsoleto a partir de Windows 8.

taskbarActivateTab y taskbar(Add/Delete)Tab

No se conocen clientes de la API.

QWinMime

La clase QWinMime ha sido reemplazada por QWindowsMimeConverter. Ver Cambios en Qt GUI#Integración nativa del portapapeles para más detalles.

QWinJumpList

Las clases QWinJumpList, QWinJumpListCategory y QWinJumpListItem han sido eliminadas debido a la necesidad de una solución multiplataforma. Véase QTBUG-94007 para más detalles.

QWinTaskbarButton

Las clases QWinTaskbarButton y QWinTaskbarProgress han sido eliminadas debido a que requieren una solución multiplataforma. Ver QTBUG-94009 y QTBUG-94008 para más detalles.

QWinThumbnailToolBar

Las clases QWinThumbnailToolBar y QWinThumbnailToolButton han sido eliminadas debido a la falta de clientes conocidos de la API.

Cambios en Qt X11 Extras

El módulo Qt X11 Extras fue eliminado en Qt 6.

• Para QX11Info::connection(), utilice QNativeInterface::QX11Application::connection() en su lugar.
• Para QX11Info::display(), use QNativeInterface::QX11Application::display() en su lugar.
• Para QX11Info::isPlatformX11(), comprueba la existencia de QNativeInterface::QX11Application en su lugar.

Asegúrate de comprobar que puedes obtener un objeto QNativeInterface::QX11Application de QGuiApplication, como en el siguiente fragmento:

    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 aún dependen de la funcionalidad de la clase QX11Info pueden incluir la cabecera privada <QtGui/private/qtx11extras_p.h> como solución provisional. Para habilitar las cabeceras privadas utiliza QT += gui-private con qmake, o añade una dependencia del proyecto a Qt::GuiPrivate con CMake.

Cambios en Qt para Android Extras

La funcionalidad clave del módulo se ha trasladado a otros módulos Qt.

Los clientes que todavía dependen de la funcionalidad que falta pueden incluir la cabecera privada <QtCore/private/qandroidextras_p.h> como solución provisional. Para habilitar las cabeceras privadas 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 reemplazadas por QJniObject y QJniEnvironment respectivamente.

La clase QAndroidJniExceptionCleaner ya no es necesaria. Ver QJniEnvironment::checkAndClearExceptions() para su reemplazo.

Espacio de nombres QtAndroid

Muchos miembros del espacio de nombres QtAndroid tienen sustitutos en la interfaz nativa QAndroidApplication.

Permisos

La infraestructura Application Permissions permite solicitar un conjunto de permisos de forma multiplataforma.

El espacio de nombres QtAndroidPrivate puede utilizarse para acceder a permisos específicos de Android no cubiertos por el sistema de permisos multiplataforma.