En esta página

QWinEventNotifier Class

La clase QWinEventNotifier ofrece compatibilidad con las funciones Wait de Windows. Más información...

Encabezado: #include <QWinEventNotifier>
CMake: find_package(Qt6 REQUIRED COMPONENTS Core)
target_link_libraries(mytarget PRIVATE Qt6::Core)
qmake: QT += core
Heredan: QObject

Funciones públicas

QWinEventNotifier(QObject *parent = nullptr)
QWinEventNotifier(QWinEventNotifier::HANDLE hEvent, QObject *parent = nullptr)
virtual ~QWinEventNotifier()
QWinEventNotifier::HANDLE handle() const
bool isEnabled() const
void setHandle(QWinEventNotifier::HANDLE hEvent)

Ranuras públicas

void setEnabled(bool enable)

Señales

void activated(QWinEventNotifier::HANDLE hEvent)

Funciones protegidas reimplementadas

virtual bool event(QEvent *e) override

Descripción detallada

La clase QWinEventNotifier permite utilizar las funciones de espera en ventanas de forma asíncrona. Con esta clase, puedes registrar un HANDLE para un evento y recibir una notificación cuando se active dicho evento. El estado del evento no se modifica durante el proceso, por lo que, si se trata de un evento de reinicio manual, será necesario reiniciarlo tras recibir la notificación.

Una vez creado un objeto de evento mediante la API de Windows, como CreateEvent() u OpenEvent(), se puede crear un notificador de eventos para supervisar el identificador del evento. Si el notificador de eventos está habilitado, emitirá la señal activated() cada vez que se active el objeto de evento correspondiente.

La función ` setEnabled()` permite tanto desactivar como activar el notificador de eventos. Por lo general, es recomendable activar o desactivar explícitamente el notificador de eventos. Un notificador desactivado no realiza ninguna acción cuando se activa el objeto de evento (el mismo efecto que si no se hubiera creado el notificador de eventos). Utiliza la función ` isEnabled()` para determinar el estado actual del notificador.

Por último, puede utilizar la función setHandle() para registrar un nuevo objeto de evento, y la función handle() para recuperar el identificador del evento.

Más información: Aunque la clase se denomina QWinEventNotifier, puede utilizarse para otros objetos denominados «objetos de sincronización», como procesos, subprocesos y temporizadores esperables.

Advertencia: esta clase solo está disponible en Windows.

Documentación de las funciones miembro

[explicit] QWinEventNotifier::QWinEventNotifier(QObject *parent = nullptr)

Crea un notificador de eventos con el ` parent` indicado.

[explicit] QWinEventNotifier::QWinEventNotifier(QWinEventNotifier::HANDLE hEvent, QObject *parent = nullptr)

Crea un notificador de eventos con el ` parent` indicado. Activa el notificador y permanece a la espera del evento ` hEvent`.

El notificador está habilitado por defecto, es decir, emite la señal activated() cada vez que se señala el evento correspondiente. Sin embargo, por lo general es recomendable habilitar o deshabilitar explícitamente el notificador de eventos.

Véanse también setEnabled() y isEnabled().

[virtual noexcept] QWinEventNotifier::~QWinEventNotifier()

Elimina este notificador.

[private signal] void QWinEventNotifier::activated(QWinEventNotifier::HANDLE hEvent)

Esta señal se emite siempre que el notificador de eventos esté activado y se active el HANDLE correspondiente.

El estado del evento no se modifica durante el proceso, por lo que, si se trata de un evento de reinicio manual, será necesario reiniciarlo tras la notificación.

El objeto se pasa en el parámetro « hEvent ».

Nota: Se trata de una señal privada. Se puede utilizar en conexiones de señales, pero el usuario no puede emitirla.

Véase también handle().

[override virtual protected] bool QWinEventNotifier::event(QEvent *e)

Reimplementa: QObject::event(QEvent *e).

QWinEventNotifier::HANDLE QWinEventNotifier::handle() const

Devuelve el HANDLE que se ha registrado en el notificador.

Véase también setHandle().

bool QWinEventNotifier::isEnabled() const

Devuelve « true » si el notificador está activado; en caso contrario, devuelve « false ».

Véase también setEnabled().

[slot] void QWinEventNotifier::setEnabled(bool enable)

Si enable es verdadero, el notificador está activado; en caso contrario, está desactivado.

Véase también isEnabled() y activated().

void QWinEventNotifier::setHandle(QWinEventNotifier::HANDLE hEvent)

Registra el HANDLE hEvent. El HANDLE anterior se dará de baja automáticamente.

Nota: Como efecto secundario, el notificador quedará desactivado y será necesario volver a activarlo.

Véase también handle() y setEnabled().

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