Auf dieser Seite

QPointerEvent Class

Eine Basisklasse für Zeigerereignisse. Mehr...

Header: #include <QPointerEvent>
CMake: find_package(Qt6 REQUIRED COMPONENTS Gui)
target_link_libraries(mytarget PRIVATE Qt6::Gui)
qmake: QT += gui
Seit: Qt 6.0
Erbt von: QInputEvent
Vererbt an:

QSinglePointEvent und QTouchEvent

Öffentliche Funktionen

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)

Neu implementierte öffentliche Funktionen

virtual void setAccepted(bool accepted) override

Geschützte Funktionen

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

Ausführliche Beschreibung

Dokumentation zu den Member-Funktionen

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

Erstellt eine Instanz von „ QPointerEvent “ mithilfe von „move“. Diese Funktion wurde gelöscht.

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

Teilt der Zustellungslogik mit, dass der angegebene „ grabber “ alle zukünftigen Aktualisierungsereignisse sowie das Freigabeereignis mit dem angegebenen „ point “ erhalten soll, unabhängig davon, wohin diese Ereignisse sonst noch zugestellt werden.

Dies ist ausschließlich für die Verwendung durch „Qt Quick “-Eingabehandler vorgesehen.

Gibt „ false “ zurück, wenn „ grabber “ bereits hinzugefügt wurde, andernfalls „ true “.

bool QPointerEvent::allPointsAccepted() const

Gibt ` true ` zurück, wenn für jeden Punkt in ` points()` die Funktion `isPointAccepted()` den Wert ` true ` zurückgibt; andernfalls ` false`.

bool QPointerEvent::allPointsGrabbed() const

Gibt „ true “ zurück, wenn jeder Punkt in „ points()“ entweder über „ exclusiveGrabber()“ oder über eine oder mehrere „ passiveGrabbers()“ verfügt.

void QPointerEvent::clearPassiveGrabbers(const QEventPoint &point)

Entfernt alle passiven Grabber aus dem angegebenen „ point “.

Diese Funktion ist ausschließlich für die Verwendung durch Eingabe-Handler von `Qt Quick ` vorgesehen.

Siehe auch QPointerEvent::addPassiveGrabber().

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

Gibt das Objekt zurück, das so konfiguriert wurde, dass es alle zukünftigen Aktualisierungsereignisse sowie das Freigabeereignis mit dem angegebenen „ point “ empfängt.

Derzeit ist diese Funktion hauptsächlich für die Verwendung in ` Qt Quick ` vorgesehen.

Siehe auch „ setExclusiveGrabber()“.

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

Gibt die Liste der Objekte zurück, für die der Empfang aller zukünftigen Aktualisierungsereignisse angefordert wurde, sowie das Freigabeereignis, das den angegebenen point enthält.

Diese Funktion ist ausschließlich für die Verwendung durch „Qt Quick “-Eingabehandler vorgesehen.

Siehe auch ` QPointerEvent::addPassiveGrabber()`.

QEventPoint &QPointerEvent::point(qsizetype i)

Gibt eine ` QEventPoint `-Referenz für den Punkt am Index ` i` zurück.

QEventPoint *QPointerEvent::pointById(int id)

Gibt den Punkt zurück, dessen ` id ` mit dem angegebenen ` id` übereinstimmt, oder ` nullptr `, falls kein solcher Punkt gefunden wird.

qsizetype QPointerEvent::pointCount() const

Gibt die Anzahl der Punkte in diesem Zeigerereignis zurück.

QPointingDevice::PointerType QPointerEvent::pointerType() const

Gibt den Typ des Punktes zurück, der das Ereignis ausgelöst hat.

const QPointingDevice *QPointerEvent::pointingDevice() const

Gibt das Quellgerät zurück, von dem dieses Ereignis stammt.

Dies entspricht der Funktion ` QInputEvent::device()`, wurde jedoch der Einfachheit halber typumgewandelt.

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

Gibt eine Liste von Punkten in diesem Zeigerereignis zurück.

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

Entfernt den passiven „ grabber “ aus dem angegebenen „ point “, sofern dieser zuvor hinzugefügt wurde. Gibt „ true “ zurück, wenn es sich zuvor um einen passiven „Grabber“ handelte, andernfalls „ false “.

Diese Funktion ist ausschließlich für die Verwendung durch „Qt Quick “-Eingabe-Handler vorgesehen.

Siehe auch QPointerEvent::addPassiveGrabber().

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

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

Teilt der Zustellungslogik mit, dass das angegebene „ exclusiveGrabber “ alle zukünftigen Aktualisierungsereignisse sowie das Freigabeereignis mit dem angegebenen „ point “ erhalten soll und dass die Zustellung an andere Elemente übersprungen werden kann.

Derzeit ist dies hauptsächlich für die Verwendung in ` Qt Quick ` vorgesehen.

Siehe auch exclusiveGrabber().

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

other Weist der Instanz „ QPointerEvent “ die Instanz „ “ zu. Diese Funktion wird gelöscht.

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

other Weist dieser „ QPointerEvent “-Instanz „ “ zu. zu dieser „ “-Instanz.

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