En esta página

QAbstractNativeEventFilter Class

La clase `QAbstractNativeEventFilter` proporciona una interfaz para recibir eventos nativos, como las estructuras de eventos MSG o XCB. Más información...

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

Funciones públicas

QAbstractNativeEventFilter()
virtual ~QAbstractNativeEventFilter()
virtual bool nativeEventFilter(const QByteArray &eventType, void *message, qintptr *result) = 0

Descripción detallada

Documentación de las funciones de miembro

QAbstractNativeEventFilter::QAbstractNativeEventFilter()

Crea un filtro de eventos nativo.

Por defecto, esto no hace nada. Recuerda instalarlo en el objeto de la aplicación.

[virtual noexcept] QAbstractNativeEventFilter::~QAbstractNativeEventFilter()

Elimina el filtro de eventos nativo.

Esto lo elimina automáticamente de la aplicación.

[pure virtual] bool QAbstractNativeEventFilter::nativeEventFilter(const QByteArray &eventType, void *message, qintptr *result)

Este método se invoca cada vez que se produce un evento nativo.

Nota: La función de filtro recibe aquí mensajes nativos, por ejemplo, estructuras de eventos MSG o XCB.

La invoca el complemento de la plataforma QPA. En Windows, la invoca el distribuidor de eventos.

El tipo de evento ` eventType ` es específico del complemento de plataforma elegido en tiempo de ejecución y puede utilizarse para convertir ` message ` al tipo adecuado.

En X11, ` eventType ` se establece en «xcb_generic_event_t», y el ` message ` se puede convertir a un puntero `xcb_generic_event_t`.

En Windows, eventType se establece en «windows_generic_MSG» para los mensajes enviados a ventanas de nivel superior, y en «windows_dispatcher_MSG» para los mensajes de todo el sistema, como los mensajes procedentes de una tecla de acceso rápido registrada. En ambos casos, message se puede convertir a un puntero MSG. El puntero result solo se utiliza en Windows y se corresponde con el puntero LRESULT.

En macOS, eventType se establece en «mac_generic_NSEvent», y message se puede convertir a un puntero NSEvent.

En tu reimplementación de esta función, si deseas filtrar el message, es decir, impedir que se siga gestionando, devuelve true; en caso contrario, devuelve false.

Ejemplo para Linux

class MyXcbEventFilter : public QAbstractNativeEventFilter
{
public:
    bool nativeEventFilter(const QByteArray &eventType, void *message, qintptr *) override
    {
        if (eventType == "xcb_generic_event_t") {
            xcb_generic_event_t* ev = static_cast<xcb_generic_event_t *>(message);
            // ...
        }
        return false;
    }
};

Ejemplo para Windows

class MyMSGEventFilter : public QAbstractNativeEventFilter
{
public:
    bool nativeEventFilter(const QByteArray &eventType, void *message, qintptr *) override
    {
        if (eventType == "windows_generic_MSG") {
            MSG *msg = static_cast<MSG *>(message);
            // ...
        } else if (eventType == "windows_dispatcher_MSG") {
            MSG *msg = static_cast<MSG *>(message);
            // ...
        }
        return false;
    }
};

Ejemplo para macOS

mycocoaeventfilter.h:

#include <QAbstractNativeEventFilter>

class MyCocoaEventFilter : public QAbstractNativeEventFilter
{
public:
    bool nativeEventFilter(const QByteArray &eventType, void *message, qintptr *) override;
};

mycocoaeventfilter.mm:

#include "mycocoaeventfilter.h"

#import <AppKit/AppKit.h>

bool MyCocoaEventFilter::nativeEventFilter(const QByteArray &eventType, void *message, qintptr *)
{
    if (eventType == "mac_generic_NSEvent") {
        NSEvent *event = static_cast<NSEvent *>(message);
        if ([event type] == NSKeyDown) {
            // Handle key event
            qDebug() << QString::fromNSString([event characters]);
        }
    }
    return false;
}

myapp.pro:

HEADERS += mycocoaeventfilter.h
OBJECTIVE_SOURCES += mycocoaeventfilter.mm
LIBS += -framework AppKit

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