QAbstractEventDispatcher Class

Documentación de funciones miembro

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

Construye un nuevo despachador de eventos con la dirección parent.

[virtual noexcept] QAbstractEventDispatcher::~QAbstractEventDispatcher()

Destruye el despachador de eventos.

[signal] void QAbstractEventDispatcher::aboutToBlock()

Esta señal se emite antes de que el bucle de eventos llame a una función que podría bloquearse.

Véase también awake().

[signal] void QAbstractEventDispatcher::awake()

Esta señal se emite después de que el bucle de eventos vuelve de una función que podría bloquearse.

Véase también wakeUp() y aboutToBlock().

bool QAbstractEventDispatcher::filterNativeEvent(const QByteArray &eventType, void *message, qintptr *result)

Envía message a través de los filtros de eventos que fueron establecidos por installNativeEventFilter(). Esta función devuelve true en cuanto un filtro de eventos devuelve true, y false en caso contrario para indicar que el procesamiento del evento debe continuar.

Las subclases de QAbstractEventDispatcher deben llamar a esta función para todos los mensajes recibidos del sistema para asegurar la compatibilidad con cualquier extensión que pueda ser utilizada en la aplicación. El tipo de evento eventType es específico del complemento de plataforma elegido en tiempo de ejecución, y puede utilizarse para asignar el mensaje al tipo correcto. El puntero result sólo se utiliza en Windows, y corresponde al puntero LRESULT.

Tenga en cuenta que el tipo de message depende de la plataforma. Véase QAbstractNativeEventFilter para más detalles.

Véase también installNativeEventFilter() y QAbstractNativeEventFilter::nativeEventFilter().

void QAbstractEventDispatcher::installNativeEventFilter(QAbstractNativeEventFilter *filterObj)

Instala un filtro de eventos filterObj para todos los eventos nativos recibidos por la aplicación.

El filtro de eventos filterObj recibe eventos a través de su función nativeEventFilter(), que es llamada para todos los eventos recibidos por todos los hilos.

La función nativeEventFilter() debe devolver true si el evento debe ser filtrado, (en este caso, detenido). Debería devolver false para permitir que el procesamiento normal de Qt continúe: el evento nativo puede entonces ser traducido a un QEvent y manejado por el filtrado estándar de Qt event, por ejemplo QObject::installEventFilter().

Si se instalan varios filtros de eventos, se activa primero el filtro que se instaló en último lugar.

Para obtener la máxima portabilidad, debería intentar utilizar siempre que sea posible objetos QEvent y QObject::installEventFilter().

Véase también QObject::installEventFilter().

[static] QAbstractEventDispatcher *QAbstractEventDispatcher::instance(QThread *thread = nullptr)

Devuelve un puntero al objeto despachador de eventos para el thread especificado. Si thread es nullptr, se utiliza el subproceso actual. Si no existe un despachador de eventos para el subproceso especificado, esta función devuelve nullptr.

Nota: Si Qt se construye sin soporte para hilos, el argumento thread se ignora.

[pure virtual] void QAbstractEventDispatcher::interrupt()

Interrumpe el envío de eventos. El despachador de eventos regresará de processEvents() tan pronto como sea posible.

[pure virtual] bool QAbstractEventDispatcher::processEvents(QEventLoop::ProcessEventsFlags flags)

Procesa los eventos pendientes que coincidan con flags hasta que no haya más eventos que procesar. Devuelve true si se ha procesado un evento; en caso contrario devuelve false.

Esta función es especialmente útil si tiene una operación de larga duración, y desea mostrar su progreso sin permitir la entrada del usuario mediante el uso de la bandera QEventLoop::ExcludeUserInputEvents.

Si la bandera QEventLoop::WaitForMoreEvents está activada en flags, el comportamiento de esta función es el siguiente:

• Si hay eventos disponibles, esta función regresa después de procesarlos.
• Si no hay eventos disponibles, esta función esperará hasta que haya más y volverá después de procesar los nuevos eventos disponibles.

Si la bandera QEventLoop::WaitForMoreEvents no está establecida en flags, y no hay eventos disponibles, esta función regresará inmediatamente.

Nota: Esta función no procesa los eventos de forma continua; vuelve después de procesar todos los eventos disponibles.

[pure virtual] void QAbstractEventDispatcher::registerSocketNotifier(QSocketNotifier *notifier)

Registra notifier con el bucle de eventos. Las subclases deben implementar este método para vincular un notificador de socket a otro bucle de eventos.

[since 6.8] void QAbstractEventDispatcher::registerTimer(Qt::TimerId timerId, QAbstractEventDispatcher::Duration interval, Qt::TimerType timerType, QObject *object)

Registra un temporizador con las direcciones timerId, interval, y timerType especificadas para la dirección object.

Esta función se introdujo en Qt 6.8.

Véase también unregisterTimer() y timersForObject().

[pure virtual] void QAbstractEventDispatcher::registerTimer(int timerId, qint64 interval, Qt::TimerType timerType, QObject *object)

Registra un temporizador con las direcciones timerId, interval, y timerType especificadas para la dirección object.

[since 6.8] Qt::TimerId QAbstractEventDispatcher::registerTimer(QAbstractEventDispatcher::Duration interval, Qt::TimerType timerType, QObject *object)

Registra un temporizador con el interval especificado y timerType para el object dado y devuelve el id del temporizador.

Esta función se introdujo en Qt 6.8.

[pure virtual] QList<QAbstractEventDispatcher::TimerInfo> QAbstractEventDispatcher::registeredTimers(QObject *object) const

Devuelve una lista de temporizadores registrados para object. La estructura TimerInfo tiene los siguientes miembros: timerId, interval, y timerType.

Véase también Qt::TimerType.

[pure virtual] int QAbstractEventDispatcher::remainingTime(int timerId)

Devuelve el tiempo restante en milisegundos con el timerId dado . Si el temporizador está inactivo, el valor devuelto será -1. Si el temporizador está vencido, el valor devuelto será 0.

Véase también Qt::TimerType.

QAbstractEventDispatcher::Duration QAbstractEventDispatcher::remainingTime(Qt::TimerId timerId) const

Devuelve el tiempo restante del temporizador con la dirección timerId. Si el temporizador está inactivo, el valor devuelto será negativo. Si el temporizador está vencido, el valor devuelto será 0.

Véase también Qt::TimerType, registerTimer(), y unregisterTimer().

void QAbstractEventDispatcher::removeNativeEventFilter(QAbstractNativeEventFilter *filter)

Elimina el filtro de eventos filter de este objeto. La petición se ignora si no se ha instalado dicho filtro de eventos.

Todos los filtros de eventos para este objeto se eliminan automáticamente cuando se destruye este objeto.

Siempre es seguro eliminar un filtro de eventos, incluso durante la activación del filtro de eventos (es decir, incluso desde dentro de la función nativeEventFilter()).

Véase también installNativeEventFilter() y QAbstractNativeEventFilter.

[since 6.8] QList<QAbstractEventDispatcher::TimerInfoV2> QAbstractEventDispatcher::timersForObject(QObject *object) const

Devuelve una lista de temporizadores registrados para object. La estructura TimerInfoV2 tiene los miembros timerId, interval, y timerType.

Esta función se introdujo en Qt 6.8.

Ver también Qt::TimerType, registerTimer(), y unregisterTimer().

[pure virtual] void QAbstractEventDispatcher::unregisterSocketNotifier(QSocketNotifier *notifier)

Desregistra notifier del despachador de eventos. Las subclases deben reimplementar este método para vincular un notificador de socket a otro bucle de eventos. Las reimplementaciones deben llamar a la implementación base.

[since 6.8] bool QAbstractEventDispatcher::unregisterTimer(Qt::TimerId timerId)

Desregistra el temporizador con la dirección timerId. Devuelve true si tiene éxito; en caso contrario devuelve false.

Esta función se introdujo en Qt 6.8.

Véase también registerTimer() y unregisterTimers().

[pure virtual] bool QAbstractEventDispatcher::unregisterTimer(int timerId)

Desregistra el temporizador con la dirección timerId. Devuelve true si tiene éxito; en caso contrario devuelve false.

Véase también registerTimer() y unregisterTimers().

[pure virtual] bool QAbstractEventDispatcher::unregisterTimers(QObject *object)

Elimina todos los temporizadores asociados a la dirección object. Devuelve true si todos los temporizadores se han eliminado correctamente; en caso contrario devuelve false.

Véase también unregisterTimer() y registeredTimers().

[pure virtual] void QAbstractEventDispatcher::wakeUp()

Activa el bucle de eventos.

Nota: Esta función es thread-safe.

Véase también awake().