En esta página

QPointerEvent Class

Una clase base para eventos de puntero. Más información...

Encabezado: #include <QPointerEvent>
CMake: find_package(Qt6 REQUIRED COMPONENTS Gui)
target_link_libraries(mytarget PRIVATE Qt6::Gui)
qmake: QT += gui
Desde: Qt 6.0
Heredado de: QInputEvent
Heredado por:

QSinglePointEvent y QTouchEvent

Funciones públicas

bool addPassiveGrabber(const QEventPoint &point, QObject *grabber)
bool allPointsAccepted() const
bool allPointsGrabbed() const
void clearPassiveGrabbers(const QEventPoint &point)
QObject *exclusiveGrabber(const QEventPoint &point) const
QList<QPointer<QObject>> passiveGrabbers(const QEventPoint &point) const
QEventPoint &point(qsizetype i)
QEventPoint *pointById(int id)
qsizetype pointCount() const
QPointingDevice::PointerType pointerType() const
const QPointingDevice *pointingDevice() const
const QList<QEventPoint> &points() const
bool removePassiveGrabber(const QEventPoint &point, QObject *grabber)
void setExclusiveGrabber(const QEventPoint &point, QObject *exclusiveGrabber)

Funciones públicas reimplementadas

virtual void setAccepted(bool accepted) override

Funciones protegidas

QPointerEvent(QPointerEvent &&)
QPointerEvent &operator=(QPointerEvent &&)
QPointerEvent &operator=(const QPointerEvent &other)

Descripción detallada

Documentación de las funciones de miembro

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

Crea una instancia de « QPointerEvent » mediante «move». Esta función ha sido eliminada.

bool QPointerEvent::addPassiveGrabber(const QEventPoint &point, QObject *grabber)

Indica a la lógica de entrega que el « grabber » especificado debe recibir todos los eventos de actualización futuros y el evento de liberación que contenga el « point » especificado, independientemente de a qué otros destinos puedan enviarse dichos eventos.

Solo está destinado a ser utilizado por los gestores de entrada deQt Quick .

Devuelve false si grabber ya se había añadido; en caso contrario, devuelve true.

bool QPointerEvent::allPointsAccepted() const

Devuelve ` true ` si `isPointAccepted()` devuelve ` true ` para cada punto de ` points()`; en caso contrario, devuelve ` false`.

bool QPointerEvent::allPointsGrabbed() const

Devuelve ` true ` si cada punto de ` points()` tiene un ` exclusiveGrabber()` o uno o más ` passiveGrabbers()`.

void QPointerEvent::clearPassiveGrabbers(const QEventPoint &point)

Elimina todos los «grabbers» pasivos de la « point » indicada.

Solo puede ser utilizado por los gestores de entrada deQt Quick .

Véase también QPointerEvent::addPassiveGrabber().

QObject *QPointerEvent::exclusiveGrabber(const QEventPoint &point) const

Devuelve el objeto que se ha configurado para recibir todos los eventos de actualización futuros y el evento de liberación que contiene el point especificado.

Por el momento, se utiliza principalmente en Qt Quick.

Véase también setExclusiveGrabber().

QList<QPointer<QObject>> QPointerEvent::passiveGrabbers(const QEventPoint &point) const

Devuelve la lista de objetos a los que se les ha solicitado que reciban todos los eventos de actualización futuros y el evento de liberación que contiene el point especificado.

Solo está destinado a ser utilizado por los gestores de entrada deQt Quick .

Véase también QPointerEvent::addPassiveGrabber().

QEventPoint &QPointerEvent::point(qsizetype i)

Devuelve una referencia de tipo ` QEventPoint ` para el punto situado en el índice ` i`.

QEventPoint *QPointerEvent::pointById(int id)

Devuelve el punto cuyo ` id ` coincide con el ` id` indicado, o ` nullptr ` si no se encuentra ningún punto de ese tipo.

qsizetype QPointerEvent::pointCount() const

Devuelve el número de puntos de este evento de puntero.

QPointingDevice::PointerType QPointerEvent::pointerType() const

Devuelve el tipo de punto que generó el evento.

const QPointingDevice *QPointerEvent::pointingDevice() const

Devuelve el dispositivo de origen del que procede este evento.

Es lo mismo que QInputEvent::device(), pero se ha convertido el tipo para mayor comodidad.

const QList<QEventPoint> &QPointerEvent::points() const

Devuelve una lista de puntos de este evento de puntero.

bool QPointerEvent::removePassiveGrabber(const QEventPoint &point, QObject *grabber)

Elimina el « grabber » pasivo del « point » indicado, en caso de que se hubiera añadido previamente. Devuelve « true » si ya había sido un «grabber» pasivo anteriormente, y « false » en caso contrario.

Solo está destinado a ser utilizado por los gestores de entrada de «Qt Quick ».

Véase también QPointerEvent::addPassiveGrabber().

[override virtual] void QPointerEvent::setAccepted(bool accepted)

void QPointerEvent::setExclusiveGrabber(const QEventPoint &point, QObject *exclusiveGrabber)

Indica a la lógica de entrega que el elemento « exclusiveGrabber » especificado debe recibir todos los eventos de actualización futuros y el evento de liberación que contenga el elemento « point » especificado, y que se puede omitir la entrega a otros elementos.

Por el momento, se utiliza principalmente en Qt Quick.

Véase también exclusiveGrabber().

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

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

[noexcept protected default] QPointerEvent &QPointerEvent::operator=(const QPointerEvent &other)

Asigna por copia other a esta instancia de QPointerEvent.

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