QHoverEvent Class
Die Klasse „QHoverEvent“ enthält Parameter, die ein Mausereignis beschreiben. Mehr...
| Header: | #include <QHoverEvent> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Gui) target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake: | QT += gui |
| Erbt von: | QSinglePointEvent |
- Liste aller Mitglieder, einschließlich geerbter Mitglieder
- Veraltete Mitglieder
- QHoverEvent ist Teil der Ereignisklassen.
Öffentliche Funktionen
| QHoverEvent(QEvent::Type type, const QPointF &scenePos, const QPointF &globalPos, const QPointF &oldPos, Qt::KeyboardModifiers modifiers = Qt::NoModifier, const QPointingDevice *device = QPointingDevice::primaryPointingDevice()) | |
| QPoint | oldPos() const |
| QPointF | oldPosF() const |
Geschützte Funktionen
| QHoverEvent(QHoverEvent &&) | |
| QHoverEvent & | operator=(QHoverEvent &&) |
| QHoverEvent & | operator=(const QHoverEvent &other) |
Ausführliche Beschreibung
Mausereignisse treten auf, wenn der Mauszeiger in ein Widget hinein-, aus diesem heraus- oder innerhalb eines Widgets bewegt wird und das Widget über das Attribut „ Qt::WA_Hover “ verfügt.
Die Funktion „ position()“ gibt die aktuelle Cursorposition zurück, während „ oldPos()“ die vorherige Mausposition angibt.
Es gibt einige Ähnlichkeiten zwischen den Ereignissen „ QEvent::HoverEnter “ und „ QEvent::HoverLeave “ sowie den Ereignissen „ QEvent::Enter “ und „ QEvent::Leave “. Sie unterscheiden sich jedoch geringfügig, da wir im Ereignis-Handler von „HoverEnter“ und „HoverLeave“ einen Aufruf von `update()` durchführen.
QEvent::HoverMove unterscheidet sich ebenfalls geringfügig von QEvent::MouseMove. Betrachten wir ein Fenster A der obersten Ebene, das ein untergeordnetes Fenster B enthält, welches wiederum ein untergeordnetes Fenster C enthält (alle mit aktiviertem Maus-Tracking):
Wenn Sie nun den Cursor in der Mitte von A von oben nach unten bewegen, erhalten Sie die folgenden „ QEvent::MouseMove “-Ereignisse:
- A::MouseMove
- B::MouseMove
- C::MouseMove
Bei „ QEvent::HoverMove “ erhalten Sie dieselben Ereignisse, mit dem Unterschied, dass sich das Ereignis immer bis zur obersten Ebene ausbreitet, unabhängig davon, ob es akzeptiert wird oder nicht. Die Ausbreitung wird nur durch das Attribut „ Qt::WA_NoMousePropagation “ gestoppt.
In diesem Fall treten die Ereignisse wie folgt auf:
- A::HoverMove
- A::HoverMove, B::HoverMove
- A::HoverMove, B::HoverMove, C::HoverMove
Dokumentation zu den Member-Funktionen
QHoverEvent::QHoverEvent(QEvent::Type type, const QPointF &scenePos, const QPointF &globalPos, const QPointF &oldPos, Qt::KeyboardModifiers modifiers = Qt::NoModifier, const QPointingDevice *device = QPointingDevice::primaryPointingDevice())
Erstellt ein Hover-Ereignisobjekt, das von device stammt.
Der Parameter „ type “ muss „ QEvent::HoverEnter “, „ QEvent::HoverLeave “ oder „ QEvent::HoverMove “ lauten.
„ scenePos “ ist die aktuelle Position des Mauszeigers relativ zum empfangenden Fenster oder zur Szene, „ oldPos “ ist die vorherige Position des Mauszeigers und „ globalPos “ ist die Mausposition in absoluten Koordinaten. „ modifiers “ enthält den Status aller Tastaturmodifikatoren zum Zeitpunkt des Ereignisses.
[protected delete] QHoverEvent::QHoverEvent(QHoverEvent &&)
Erstellt eine Instanz von ` QHoverEvent`. Diese Funktion wurde gelöscht.
QPoint QHoverEvent::oldPos() const
Gibt die vorherige Position des Mauszeigers relativ zu dem Widget zurück, das das Ereignis empfangen hat. Wenn keine vorherige Position vorliegt, gibt `oldPos()` dieselbe Position zurück wie ` position()`.
Bei „ QEvent::HoverEnter “-Ereignissen ist diese Position immer „ QPoint “ (-1, -1).
Siehe auch ` position()`.
QPointF QHoverEvent::oldPosF() const
Gibt die vorherige Position des Mauszeigers relativ zu dem Widget zurück, das das Ereignis empfangen hat. Wenn keine vorherige Position vorliegt, gibt oldPosF() dieselbe Position zurück wie position().
Bei „ QEvent::HoverEnter “-Ereignissen ist diese Position immer „ QPointF “ (-1, -1).
Siehe auch „ position()“.
[protected delete] QHoverEvent &QHoverEvent::operator=(QHoverEvent &&)
Weist „ other “ dieser „ QHoverEvent “-Instanz zu. Diese Funktion wird gelöscht.
[noexcept protected default] QHoverEvent &QHoverEvent::operator=(const QHoverEvent &other)
other Weist dieser Instanz von „ QHoverEvent “ den Wert „ “ zu. “ zu dieser Instanz von „ “ zu.
© 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.
