En esta página

Cambios en Qt Widgets

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 para hacer de Qt un marco de trabajo mejor.

En este tema resumimos esos cambios en Qt Widgets y ofrecemos orientación para gestionarlos.

Clases del núcleo

La clase QWidget

El manejador virtual QWidget::enterEvent() ahora recibe un parámetro de tipo QEnterEvent*, que contiene información sobre la posición del puntero, en lugar de un simple QEvent*.

QDesktopWidget y QApplication::desktop()

QDesktopWidget ya estaba en desuso en Qt 5 y se ha eliminado en Qt 6, junto con QApplication::desktop().

QScreen Ofrece una funcionalidad equivalente para consultar información sobre las pantallas disponibles, las pantallas que forman un escritorio virtual y las geometrías de las pantallas.

Utiliza ` QWidget::setScreen()` para crear un ` QWidget ` en una pantalla específica; ten en cuenta que esto no mueve un widget a una pantalla en una configuración de escritorio virtual.

QAction, QActionGroup

Estas clases se han trasladado al módulo QtGui. Las funciones miembro que dependen de tipos definidos en QtWidgets (como QAction::menu() y QAction::setMenu()) se implementan como plantillas que solo se instanciarán cuando se llamen.

Widgets

La clase QAbstractButton

Se ha eliminado el parámetro de tiempo de espera predeterminado de ` QAbstractButton::animateClick()` para permitir el uso de la sintaxis de conexión moderna sin necesidad de ` qOverload`.

La clase QComboBox

La función ` QComboBox::setModel()` ahora es virtual.

La clase QDateTimeEdit

Cuando se llama a ` QDateTimeEdit::setDateTime()` con una fecha y hora cuya especificación de tiempo no coincide con la de la instancia ` QDateTimeEdit `, la fecha y hora se convierten a la especificación de tiempo de ` QDateTimeEdit`. Esto proporciona una fecha y hora que describe el mismo instante en el tiempo, pero lo hace en los mismos términos que utiliza ` QDateTimeEdit `. Anteriormente, la fecha y la hora de la fecha y hora pasada se combinaban con la especificación de hora del widget, ignorando la especificación de hora de la fecha y hora; esto podía describir un momento diferente al descrito por la fecha y hora pasada.

ItemViews

La clase QAbstractItemView

El método virtual `viewOptions()`, que anteriormente devolvía un objeto ` QStyleOptionViewItem `, ha pasado a llamarse `initViewItemOption` e inicializa un objeto ` QStyleOptionViewItem ` que se pasa a través de un puntero.

Se han consolidado todas las subclases versionadas de ` QStyleOption `, y los números de versión se han restablecido a 1.

Los distintos métodos initStyleOption() de las clases de widgets son ahora virtuales.

Cambios en las hojas de estilo

La aplicación de estilos a un widget mediante su propiedad en Qt 5 y en Qt 6 es diferente, especialmente si la propiedad es una enumeración. En Qt 5, el valor del selector para dicha propiedad es el equivalente entero del valor de la enumeración, mientras que en Qt 6 se utiliza el valor de cadena. El siguiente ejemplo ilustra esta diferencia:

// Qt 5 style sheet
QToolButton[popupMode="1"] {
    padding-right: 20px;
}
// Qt 6 style sheet
QToolButton[popupMode=MenuButtonPopup] {
    padding-right: 20px;
}

Clases de utilidad

QUndoCommand, QUndoStack y QUndoGroup

Las clases independientes de los widgets del marco de trabajo «Deshacer/Rehacer» se han trasladado al módulo « QtGui ».

© 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.