En esta página

QEvent Class

La clase QEvent es la clase base de todas las clases de eventos. Los objetos de evento contienen parámetros de evento. Más información...

Tipos públicos

enum Type { None, ActionAdded, ActionChanged, ActionRemoved, ActivationChange, …, MaxUser }

Propiedades

Funciones públicas

QEvent(QEvent::Type type)
virtual ~QEvent()
void accept()
(since 6.0) virtual QEvent *clone() const
void ignore()
bool isAccepted() const
(since 6.0) bool isInputEvent() const
(since 6.0) bool isPointerEvent() const
(since 6.0) bool isSinglePointEvent() const
virtual void setAccepted(bool accepted)
bool spontaneous() const
QEvent::Type type() const

Miembros públicos estáticos

int registerEventType(int hint = -1)

Funciones protegidas

QEvent(QEvent &&)
QEvent &operator=(QEvent &&)

Descripción detallada

El bucle de eventos principal de Qt (QCoreApplication::exec()) recupera los eventos nativos del sistema de ventanas de la cola de eventos, los convierte en QEvents y envía los eventos convertidos a los objetos ` QObject`.

En general, los eventos proceden del sistema de ventanas subyacente (spontaneous() devuelve true), pero también es posible enviar eventos manualmente mediante QCoreApplication::sendEvent() y QCoreApplication::postEvent() (spontaneous() devuelve false).

QObjects reciben eventos mediante la llamada a su función QObject::event(). La función se puede reimplementar en subclases para personalizar la gestión de eventos y añadir tipos de eventos adicionales; QWidget::event() es un ejemplo destacado. Por defecto, los eventos se envían a controladores de eventos como QObject::timerEvent() y QWidget::mouseMoveEvent(). QObject::installEventFilter() permite a un objeto interceptar eventos destinados a otro objeto.

El QEvent básico contiene únicamente un parámetro de tipo de evento y un indicador de «aceptación». El indicador de aceptación se establece con accept() y se desactiva con ignore(). Está activado por defecto, pero no hay que darlo por sentado, ya que las subclases pueden optar por desactivarlo en su constructor.

Las subclases de `QEvent` contienen parámetros adicionales que describen el evento concreto.

Véase también QObject::event(), QObject::installEventFilter(), QCoreApplication::sendEvent(), QCoreApplication::postEvent() y QCoreApplication::processEvents().

Documentación sobre tipos de miembro

enum QEvent::Type

Este tipo de enumeración define los tipos de eventos válidos en Qt. Los tipos de eventos y las clases especializadas para cada tipo son los siguientes:

ConstanteValorDescripción
QEvent::None0No es un evento.
QEvent::ActionAdded114Se ha añadido una nueva acción (QActionEvent).
QEvent::ActionChanged113Se ha modificado una acción (QActionEvent).
QEvent::ActionRemoved115Se ha eliminado una acción (QActionEvent).
QEvent::ActivationChange99Ha cambiado el estado de activación de la ventana de nivel superior de un widget.
QEvent::ApplicationActivate121Esta enumeración ha quedado obsoleta. Utiliza ApplicationStateChange en su lugar.
QEvent::ApplicationActivatedApplicationActivateEsta enumeración ha quedado obsoleta. Utiliza ApplicationStateChange en su lugar.
QEvent::ApplicationDeactivate122Esta enumeración ha quedado obsoleta. Utiliza ApplicationStateChange en su lugar.
QEvent::ApplicationFontChange36Ha cambiado la fuente predeterminada de la aplicación.
QEvent::ApplicationLayoutDirectionChange37La dirección de diseño predeterminada de la aplicación ha cambiado.
QEvent::ApplicationPaletteChange38La paleta predeterminada de la aplicación ha cambiado.
QEvent::ApplicationStateChange214El estado de la aplicación ha cambiado.
QEvent::ApplicationWindowIconChange35El icono de la aplicación ha cambiado.
QEvent::ChildAdded68Un objeto obtiene un elemento secundario (QChildEvent).
QEvent::ChildPolished69Un widget hijo se ha pulido (QChildEvent).
QEvent::ChildRemoved71Un objeto pierde un elemento secundario (QChildEvent).
QEvent::ChildWindowAdded (since Qt 6.7)223Se ha añadido una ventana secundaria a la ventana (QChildWindowEvent).
QEvent::ChildWindowRemoved (since Qt 6.7)224Se ha eliminado una ventana secundaria de la ventana (QChildWindowEvent).
QEvent::Clipboard40El contenido del portapapeles ha cambiado.
QEvent::Close19Se ha cerrado el widget (QCloseEvent).
QEvent::CloseSoftwareInputPanel200Un widget desea cerrar el panel de entrada de software (SIP).
QEvent::ContentsRectChange178Los márgenes del rectángulo de contenido del widget han cambiado.
QEvent::ContextMenu82Menú contextual emergente (QContextMenuEvent).
QEvent::CursorChange183El cursor del widget ha cambiado.
QEvent::DeferredDelete52El objeto se eliminará una vez que se haya liberado (QDeferredDeleteEvent)
QEvent::DevicePixelRatioChange (since Qt 6.6)222El devicePixelRatio ha cambiado para el almacén subyacente de este widget o ventana.
QEvent::DragEnter60El cursor entra en un widget durante una operación de arrastrar y soltar (QDragEnterEvent).
QEvent::DragLeave62El cursor sale de un widget durante una operación de arrastrar y soltar (QDragLeaveEvent).
QEvent::DragMove61Se está llevando a cabo una operación de arrastrar y soltar (QDragMoveEvent).
QEvent::Drop63Se ha completado una operación de arrastrar y soltar (QDropEvent).
QEvent::DynamicPropertyChange170Se ha añadido, modificado o eliminado una propiedad dinámica del objeto.
QEvent::EnabledChange98El estado de activación del widget ha cambiado.
QEvent::Enter10El ratón entra en los límites del widget (QEnterEvent).
QEvent::EnterWhatsThisMode124Se envía a los widgets de nivel superior cuando la aplicación entra en el modo «¿Qué es esto?».
QEvent::Expose206Se envía a una ventana cuando su contenido en pantalla queda invalidado y debe vaciarse del almacén de respaldo.
QEvent::FileOpen116Solicitud de apertura de archivo (QFileOpenEvent).
QEvent::FocusIn8El widget o la ventana obtiene el foco del teclado (QFocusEvent).
QEvent::FocusOut9El widget o la ventana pierde el foco del teclado (QFocusEvent).
QEvent::FocusAboutToChange23El foco de un widget o una ventana está a punto de cambiar (QFocusEvent)
QEvent::FontChange97La fuente del widget ha cambiado.
QEvent::Gesture198Se ha activado un gesto (QGestureEvent).
QEvent::GestureOverride202Se ha activado una anulación de gesto (QGestureEvent).
QEvent::GrabKeyboard188El elemento pasa a estar seleccionado mediante el teclado (soloQGraphicsItem ).
QEvent::GrabMouse186El elemento obtiene control del ratón (soloQGraphicsItem ).
QEvent::GraphicsSceneContextMenu159Menú contextual sobre una escena gráfica (QGraphicsSceneContextMenuEvent).
QEvent::GraphicsSceneDragEnter164El cursor entra en una escena gráfica durante una operación de arrastrar y soltar (QGraphicsSceneDragDropEvent).
QEvent::GraphicsSceneDragLeave166El cursor sale de una escena gráfica durante una operación de arrastrar y soltar (QGraphicsSceneDragDropEvent).
QEvent::GraphicsSceneDragMove165Se está realizando una operación de arrastrar y soltar sobre una escena (QGraphicsSceneDragDropEvent).
QEvent::GraphicsSceneDrop167Se ha completado una operación de arrastrar y soltar en una escena (QGraphicsSceneDragDropEvent).
QEvent::GraphicsSceneHelp163El usuario solicita ayuda para una escena gráfica (QHelpEvent).
QEvent::GraphicsSceneHoverEnter160El cursor del ratón se sitúa sobre un elemento de desplazamiento en una escena gráfica (QGraphicsSceneHoverEvent).
QEvent::GraphicsSceneHoverLeave162El cursor del ratón sale de un elemento sobre el que se ha situado el cursor en una escena gráfica (QGraphicsSceneHoverEvent).
QEvent::GraphicsSceneHoverMove161El cursor del ratón se desplaza dentro de un elemento sobre el que se pasa el cursor en una escena gráfica (QGraphicsSceneHoverEvent).
QEvent::GraphicsSceneMouseDoubleClick158Vuelve a pulsar el ratón (doble clic) en una escena gráfica (QGraphicsSceneMouseEvent).
QEvent::GraphicsSceneMouseMove155Mover el ratón en una escena gráfica (QGraphicsSceneMouseEvent).
QEvent::GraphicsSceneMousePress156Pulsar el ratón en una escena gráfica (QGraphicsSceneMouseEvent).
QEvent::GraphicsSceneMouseRelease157Suelta el ratón en una escena gráfica (QGraphicsSceneMouseEvent).
QEvent::GraphicsSceneMove182Se ha movido el widget (QGraphicsSceneMoveEvent).
QEvent::GraphicsSceneResize181Se ha cambiado el tamaño del widget (QGraphicsSceneResizeEvent).
QEvent::GraphicsSceneWheel168Se ha girado la rueda del ratón en una escena gráfica (QGraphicsSceneWheelEvent).
QEvent::GraphicsSceneLeave220El cursor sale de una escena gráfica (QGraphicsSceneWheelEvent).
QEvent::Hide18Se ha ocultado el widget (QHideEvent).
QEvent::HideToParent27Se ha ocultado un widget secundario.
QEvent::HoverEnter127El cursor del ratón entra en un widget de desplazamiento (QHoverEvent).
QEvent::HoverLeave128El cursor del ratón sale de un widget de hover (QHoverEvent).
QEvent::HoverMove129El cursor del ratón se desplaza dentro de un widget de desplazamiento (QHoverEvent).
QEvent::IconDrag96Se ha arrastrado fuera el icono principal de una ventana (QIconDragEvent).
QEvent::IconTextChange101Se ha cambiado el texto del icono de un widget. (Obsoleto)
QEvent::InputMethod83Se está utilizando un método de entrada (QInputMethodEvent).
QEvent::InputMethodQuery207Un evento de consulta del método de entrada (QInputMethodQueryEvent)
QEvent::KeyboardLayoutChange169La distribución del teclado ha cambiado.
QEvent::KeyPress6Pulsación de tecla (QKeyEvent).
QEvent::KeyRelease7Se ha soltado una tecla (QKeyEvent).
QEvent::LanguageChange89Ha cambiado la traducción de la aplicación.
QEvent::LayoutDirectionChange90Ha cambiado la orientación de las distribuciones.
QEvent::LayoutRequest76Hay que rehacer la disposición de los widgets.
QEvent::Leave11El ratón sale de los límites del widget.
QEvent::LeaveWhatsThisMode125Enviar a los widgets de nivel superior cuando la aplicación sale del modo «¿Qué es esto?».
QEvent::LocaleChange88La configuración regional del sistema ha cambiado.
QEvent::NonClientAreaMouseButtonDblClick176Se ha producido un doble clic del ratón fuera del área de cliente (QMouseEvent).
QEvent::NonClientAreaMouseButtonPress174Se ha pulsado un botón del ratón fuera del área de cliente (QMouseEvent).
QEvent::NonClientAreaMouseButtonRelease175Se ha soltado un botón del ratón fuera del área de cliente (QMouseEvent).
QEvent::NonClientAreaMouseMove173Se ha producido un movimiento del ratón fuera del área de cliente (QMouseEvent).
QEvent::MacSizeChange177El usuario ha modificado el tamaño de sus widgets (solo en macOS).
QEvent::MetaCall43Se ha producido una invocación asíncrona de un método a través de QMetaObject::invokeMethod().
QEvent::ModifiedChange102Se ha modificado el estado de los widgets.
QEvent::MouseButtonDblClick4Se ha vuelto a pulsar el ratón (QMouseEvent).
QEvent::MouseButtonPress2Pulsación del ratón (QMouseEvent).
QEvent::MouseButtonRelease3Se ha soltado el ratón (QMouseEvent).
QEvent::MouseMove5Movimiento del ratón (QMouseEvent).
QEvent::MouseTrackingChange109El estado de seguimiento del ratón ha cambiado.
QEvent::Move13La posición del widget ha cambiado (QMoveEvent).
QEvent::NativeGesture197El sistema ha detectado un gesto (QNativeGestureEvent).
QEvent::OrientationChange208La orientación de la pantalla ha cambiado (QScreenOrientationChangeEvent).
QEvent::Paint12Es necesario actualizar la pantalla (QPaintEvent).
QEvent::PaletteChange39Ha cambiado la paleta del widget.
QEvent::ParentAboutToChange131El objeto padre está a punto de cambiar. Solo se envía a algunos tipos de objetos, como QWidget.
QEvent::ParentChange21El objeto padre ha cambiado. Solo se envía a determinados tipos de objetos, como QWidget.
QEvent::ParentWindowAboutToChange (since Qt 6.7)225La ventana padre está a punto de cambiar.
QEvent::ParentWindowChange (since Qt 6.7)226La ventana principal ha cambiado.
QEvent::PlatformPanel212Se ha solicitado un panel específico de la plataforma.
QEvent::PlatformSurface217Se ha creado una superficie nativa de la plataforma o está a punto de ser destruida (QPlatformSurfaceEvent).
QEvent::Polish75El widget está pulido.
QEvent::PolishRequest74El widget debería pulirse.
QEvent::QueryWhatsThis123El widget debería aceptar el evento si dispone de la ayuda «¿Qué es esto?» (QHelpEvent).
QEvent::Quit20La aplicación se ha cerrado.
QEvent::ReadOnlyChange (since Qt 5.4)106El estado de solo lectura del widget ha cambiado.
QEvent::RequestSoftwareInputPanel199Un widget quiere abrir un panel de entrada de software (SIP).
QEvent::Resize14El tamaño del widget ha cambiado (QResizeEvent).
QEvent::ScrollPrepare204El objeto necesita completar su información geométrica (QScrollPrepareEvent).
QEvent::Scroll205El objeto necesita desplazarse hasta la posición indicada (QScrollEvent).
QEvent::Shortcut117Se ha pulsado una tecla en el elemento secundario para la gestión de teclas de acceso rápido (QShortcutEvent).
QEvent::ShortcutOverride51Pulsación de tecla en el elemento secundario, para anular el manejo de teclas de acceso rápido (QKeyEvent). Cuando un atajo está a punto de activarse, se envía un evento « ShortcutOverride » a la ventana activa. Esto permite a los clientes (por ejemplo, los widgets) indicar que gestionarán el atajo por sí mismos, aceptando el evento. Si se acepta la anulación del atajo, el evento se envía como una pulsación de tecla normal al widget que tiene el foco. De lo contrario, se activa la acción del atajo, si existe.
QEvent::Show17Se ha mostrado el widget en pantalla (QShowEvent).
QEvent::ShowToParent26Se ha mostrado un widget secundario.
QEvent::SockAct50Se ha activado un socket, utilizado para implementar QSocketNotifier.
QEvent::StateMachineSignal192Se ha enviado una señal a una máquina de estados (QStateMachine::SignalEvent).
QEvent::StateMachineWrapped193El evento es un contenedor de, es decir, contiene, otro evento (QStateMachine::WrappedEvent).
QEvent::StatusTip112Se ha solicitado una información de estado (QStatusTipEvent).
QEvent::StyleChange100Se ha modificado el estilo del widget.
QEvent::TabletMove87Movimiento de la tableta Wacom (QTabletEvent).
QEvent::TabletPress92Pulsación de la tableta Wacom (QTabletEvent).
QEvent::TabletRelease93Se suelta la tableta Wacom (QTabletEvent).
QEvent::TabletEnterProximity171Evento de proximidad de la tableta Wacom (QTabletEvent), enviado a QApplication.
QEvent::TabletLeaveProximity172Evento de salida de proximidad de la tableta Wacom (QTabletEvent), enviado a QApplication.
QEvent::TabletTrackingChange (since Qt 5.9)219El estado de seguimiento de la tableta Wacom ha cambiado.
QEvent::ThreadChange22El objeto se ha trasladado a otro hilo. Este es el último evento enviado a este objeto en el hilo anterior. Véase QObject::moveToThread().
QEvent::Timer1Eventos de temporizador regulares (QTimerEvent).
QEvent::ToolBarChange120Se ha activado o desactivado el botón de la barra de herramientas en macOS.
QEvent::ToolTip110Se ha solicitado una descripción emergente (QHelpEvent).
QEvent::ToolTipChange184La información sobre herramientas del widget ha cambiado.
QEvent::TouchBegin194Inicio de una secuencia de eventos de pantalla táctil o trackpad (QTouchEvent).
QEvent::TouchCancel209Cancelación de la secuencia de eventos táctiles (QTouchEvent).
QEvent::TouchEnd196Fin de una secuencia de eventos táctiles (QTouchEvent).
QEvent::TouchUpdate195Evento de pantalla táctil (QTouchEvent).
QEvent::UngrabKeyboard189El elemento pierde el control del teclado (soloQGraphicsItem ).
QEvent::UngrabMouse187El elemento pierde el control del ratón (QGraphicsItem, QQuickItem).
QEvent::UpdateLater78El widget debe ponerse en cola para ser redibujado más adelante.
QEvent::UpdateRequest77El widget debe volver a dibujarse.
QEvent::WhatsThis111El widget debe mostrar la ayuda «¿Qué es esto?» (QHelpEvent).
QEvent::WhatsThisClicked118Se ha hecho clic en un enlace de la ayuda «¿Qué es esto?» de un widget.
QEvent::Wheel31Se ha girado la rueda del ratón (QWheelEvent).
QEvent::WinEventAct132Se ha producido un evento de activación específico de Windows.
QEvent::WindowActivate24Se ha activado la ventana.
QEvent::WindowBlocked103La ventana está bloqueada por un cuadro de diálogo modal.
QEvent::WindowDeactivate25Se ha desactivado la ventana.
QEvent::WindowIconChange34El icono de la ventana ha cambiado.
QEvent::WindowStateChange105El estado de la ventana ( window's state, minimizada, maximizada o a pantalla completa) ha cambiado (QWindowStateChangeEvent).
QEvent::WindowTitleChange33El título de la ventana ha cambiado.
QEvent::WindowUnblocked104La ventana se ha desbloqueado tras el cierre de un cuadro de diálogo modal.
QEvent::WinIdChange203El identificador del sistema de la ventana para este widget nativo ha cambiado.
QEvent::ZOrderChange126Ha cambiado el orden de superposición del widget. Este evento nunca se envía a las ventanas de nivel superior.
QEvent::SafeAreaMarginsChange (since Qt 6.9)227Los márgenes del área segura de la ventana han cambiado.

Los eventos de usuario deben tener valores comprendidos entre User y MaxUser:

ConstanteValorDescripción
QEvent::User1000Evento definido por el usuario.
QEvent::MaxUser65535ID del último evento de usuario.

Para mayor comodidad, puedes utilizar la función registerEventType() para registrar y reservar un tipo de evento personalizado para tu aplicación. De este modo, evitarás reutilizar accidentalmente un tipo de evento personalizado que ya se esté utilizando en otra parte de tu aplicación.

Documentación de la propiedad

accepted : bool

Esta propiedad contiene el indicador «accept» del objeto de evento.

Establecer el parámetro «accept» indica que el receptor del evento desea recibir dicho evento. Los eventos no deseados podrían propagarse al widget padre. Por defecto, isAccepted() está establecido en «true», pero no confíes en ello, ya que las subclases pueden optar por desactivarlo en su constructor.

Para mayor comodidad, el indicador de aceptación también se puede establecer con ` accept()` y desactivar con ` ignore()`.

Nota: Al aceptar un QPointerEvent, se desmarcan implícitamente ( accepts ) todos los points que conlleva el evento.

Funciones de acceso:

bool isAccepted() const
virtual void setAccepted(bool accepted)

Documentación de funciones de miembro

[explicit] QEvent::QEvent(QEvent::Type type)

Crea un objeto de evento de tipo ` type`.

[protected delete] QEvent::QEvent(QEvent &&)

Crea una instancia de ` QEvent`. Esta función se ha eliminado.

[virtual noexcept] QEvent::~QEvent()

Elimina el evento. Si se trataba de un evento « posted », se eliminará de la lista de eventos pendientes de publicar.

void QEvent::accept()

Establece el indicador «accept» del objeto de evento, lo que equivale a llamar a « setAccepted » (true).

Al establecer el parámetro «accept» se indica que el receptor del evento desea recibir dicho evento. Los eventos no deseados podrían propagarse al widget padre.

Véase también ignore().

[virtual, since 6.0] QEvent *QEvent::clone() const

Crea y devuelve una copia idéntica de este evento.

Esta función se introdujo en Qt 6.0.

void QEvent::ignore()

Borra el parámetro «accept» del objeto de evento, lo que equivale a llamar a « setAccepted(false)».

Al borrar el parámetro «accept» se indica que el receptor del evento no desea recibir dicho evento. Los eventos no deseados podrían propagarse al widget padre.

Véase también accept().

[noexcept, since 6.0] bool QEvent::isInputEvent() const

Devuelve ` true ` si el objeto de evento es un ` QInputEvent ` o una de sus subclases.

Esta función se introdujo en Qt 6.0.

[noexcept, since 6.0] bool QEvent::isPointerEvent() const

Devuelve ` true ` si el objeto de evento es un ` QPointerEvent ` o una de sus subclases.

Esta función se introdujo en Qt 6.0.

[noexcept, since 6.0] bool QEvent::isSinglePointEvent() const

Devuelve ` true ` si el objeto de evento es una subclase de ` QSinglePointEvent`.

Esta función se introdujo en Qt 6.0.

[static noexcept] int QEvent::registerEventType(int hint = -1)

Registra y devuelve un tipo de evento personalizado. Se utilizará el ` hint ` proporcionado si está disponible; de lo contrario, devolverá un valor comprendido entre ` QEvent::User ` y ` QEvent::MaxUser ` que aún no se haya registrado. El ` hint ` se ignora si su valor no está comprendido entre ` QEvent::User ` y ` QEvent::MaxUser`.

Devuelve -1 si todos los valores disponibles ya están ocupados o si el programa se está cerrando.

Nota: Esta función es segura para subprocesos.

bool QEvent::spontaneous() const

Devuelve « true » si el evento se originó fuera de la aplicación (un evento del sistema); en caso contrario, devuelve « false ».

QEvent::Type QEvent::type() const

Devuelve el tipo de evento.

[protected delete] QEvent &QEvent::operator=(QEvent &&)

Asigna mediante «move» other a esta instancia de QEvent. Esta función se elimina.

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