 |
Qt
Internal/Contributor docs for the Qt SDK. Note: These are NOT official API docs; those are found at https://doc.qt.io/
|
|
Qt
Internal/Contributor docs for the Qt SDK. Note: These are NOT official API docs; those are found at https://doc.qt.io/
|
\inmodule QtGui More...
#include <qevent.h>
Inheritance diagram for QHoverEvent: Collaboration diagram for QHoverEvent:Public Member Functions | |
| QHoverEvent (Type type, const QPointF &scenePos, const QPointF &globalPos, const QPointF &oldPos, Qt::KeyboardModifiers modifiers=Qt::NoModifier, const QPointingDevice *device=QPointingDevice::primaryPointingDevice()) | |
| Constructs a hover event object originating from device. | |
| bool | isUpdateEvent () const override |
| QPoint | oldPos () const |
| Returns the previous position of the mouse cursor, relative to the widget that received the event. | |
| QPointF | oldPosF () const |
| Returns the previous position of the mouse cursor, relative to the widget that received the event. | |
| Public Member Functions inherited from QSinglePointEvent | |
| Qt::MouseButton | button () const |
| Returns the button that caused the event. | |
| Qt::MouseButtons | buttons () const |
| Returns the button state when the event was generated. | |
| QPointF | position () const |
| Returns the position of the point in this event, relative to the widget or item that received the event. | |
| QPointF | scenePosition () const |
| Returns the position of the point in this event, relative to the window or scene. | |
| QPointF | globalPosition () const |
| Returns the position of the point in this event on the screen or virtual desktop. | |
| bool | isBeginEvent () const override |
Returns true if this event represents a \l {button()}{button} being pressed. | |
| bool | isUpdateEvent () const override |
Returns true if this event does not include a change in \l {buttons()}{button state}. | |
| bool | isEndEvent () const override |
Returns true if this event represents a \l {button()}{button} being released. | |
| QObject * | exclusivePointGrabber () const |
| void | setExclusivePointGrabber (QObject *exclusiveGrabber) |
| Public Member Functions inherited from QPointerEvent | |
| QPointerEvent (Type type, const QPointingDevice *dev, Qt::KeyboardModifiers modifiers=Qt::NoModifier, const QList< QEventPoint > &points={}) | |
| const QPointingDevice * | pointingDevice () const |
| Returns the source device from which this event originates. | |
| QPointingDevice::PointerType | pointerType () const |
| Returns the type of point that generated the event. | |
| void | setTimestamp (quint64 timestamp) override |
| qsizetype | pointCount () const |
| Returns the number of points in this pointer event. | |
| QEventPoint & | point (qsizetype i) |
| Returns a QEventPoint reference for the point at index i. | |
| const QList< QEventPoint > & | points () const |
| Returns a list of points in this pointer event. | |
| QEventPoint * | pointById (int id) |
Returns the point whose \l {QEventPoint::id()}{id} matches the given id, or nullptr if no such point is found. | |
| bool | allPointsGrabbed () const |
Returns true if every point in points() has either an exclusiveGrabber() or one or more passiveGrabbers(). | |
| bool | allPointsAccepted () const |
Returns true if isPointAccepted() is true for every point in points(); otherwise false. | |
| virtual void | setAccepted (bool accepted) override |
| \reimp | |
| QObject * | exclusiveGrabber (const QEventPoint &point) const |
| Returns the object which has been set to receive all future update events and the release event containing the given point. | |
| void | setExclusiveGrabber (const QEventPoint &point, QObject *exclusiveGrabber) |
| Informs the delivery logic that the given exclusiveGrabber is to receive all future update events and the release event containing the given point, and that delivery to other items can be skipped. | |
| QList< QPointer< QObject > > | passiveGrabbers (const QEventPoint &point) const |
| Returns the list of objects that have been requested to receive all future update events and the release event containing the given point. | |
| void | clearPassiveGrabbers (const QEventPoint &point) |
| Removes all passive grabbers from the given point. | |
| bool | addPassiveGrabber (const QEventPoint &point, QObject *grabber) |
| Informs the delivery logic that the given grabber is to receive all future update events and the release event containing the given point, regardless where else those events may be delivered. | |
| bool | removePassiveGrabber (const QEventPoint &point, QObject *grabber) |
| Removes the passive grabber from the given point if it was previously added. | |
| Public Member Functions inherited from QInputEvent | |
| QInputEvent (Type type, const QInputDevice *m_dev, Qt::KeyboardModifiers modifiers=Qt::NoModifier) | |
| const QInputDevice * | device () const |
| QInputDevice::DeviceType | deviceType () const |
| Returns the type of device that generated the event. | |
| Qt::KeyboardModifiers | modifiers () const |
| Returns the keyboard modifier flags that existed immediately before the event occurred. | |
| void | setModifiers (Qt::KeyboardModifiers modifiers) |
| quint64 | timestamp () const |
| Returns the window system's timestamp for this event. | |
| Public Member Functions inherited from QEvent | |
| QEvent (Type type) | |
| Constructs an event object of type type. | |
| virtual | ~QEvent () |
| Destroys the event. | |
| Type | type () const |
| Returns the event type. | |
| bool | spontaneous () const |
Returns true if the event originated outside the application (a system event); otherwise returns false. | |
| bool | isAccepted () const |
| void | accept () |
| Sets the accept flag of the event object, the equivalent of calling setAccepted(true). | |
| void | ignore () |
| Clears the accept flag parameter of the event object, the equivalent of calling setAccepted(false). | |
| bool | isInputEvent () const noexcept |
| bool | isPointerEvent () const noexcept |
| bool | isSinglePointEvent () const noexcept |
| virtual QEvent * | clone () const |
| Creates and returns an identical copy of this event. | |
Protected Attributes | |
| QPointF | m_oldPos |
| Protected Attributes inherited from QSinglePointEvent | |
| Qt::MouseButton | m_button = Qt::NoButton |
| Qt::MouseButtons | m_mouseState = Qt::NoButton |
| Qt::MouseEventSource | m_source |
| quint16 | m_reserved |
| quint16 | m_reserved2: 11 |
| quint16 | m_doubleClick: 1 |
| quint16 | m_phase: 3 |
| quint16 | m_invertedScrolling: 1 |
| Protected Attributes inherited from QPointerEvent | |
| QList< QEventPoint > | m_points |
| Protected Attributes inherited from QInputEvent | |
| const QInputDevice * | m_dev = nullptr |
| quint64 | m_timeStamp = 0 |
| Qt::KeyboardModifiers | m_modState = Qt::NoModifier |
| quint32 | m_reserved = 0 |
| Protected Attributes inherited from QEvent | |
| quint16 | t |
\inmodule QtGui
The QHoverEvent class contains parameters that describe a mouse event.
Mouse events occur when a mouse cursor is moved into, out of, or within a widget, and if the widget has the Qt::WA_Hover attribute.
The function pos() gives the current cursor position, while oldPos() gives the old mouse position.
There are a few similarities between the events QEvent::HoverEnter and QEvent::HoverLeave, and the events QEvent::Enter and QEvent::Leave. However, they are slightly different because we do an update() in the event handler of HoverEnter and HoverLeave.
QEvent::HoverMove is also slightly different from QEvent::MouseMove. Let us consider a top-level window A containing a child B which in turn contains a child C (all with mouse tracking enabled):
Now, if you move the cursor from the top to the bottom in the middle of A, you will get the following QEvent::MouseMove events:
\list 1
You will get the same events for QEvent::HoverMove, except that the event always propagates to the top-level regardless whether the event is accepted or not. It will only stop propagating with the Qt::WA_NoMousePropagation attribute.
In this case the events will occur in the following way:
\list 1
| QHoverEvent::QHoverEvent | ( | Type | type, |
| const QPointF & | scenePos, | ||
| const QPointF & | globalPos, | ||
| const QPointF & | oldPos, | ||
| Qt::KeyboardModifiers | modifiers = Qt::NoModifier, | ||
| const QPointingDevice * | device = QPointingDevice::primaryPointingDevice() ) |
Constructs a hover event object originating from device.
The type parameter must be QEvent::HoverEnter, QEvent::HoverLeave, or QEvent::HoverMove.
The scenePos is the current mouse cursor's position relative to the receiving window or scene, oldPos is its previous such position, and globalPos is the mouse position in absolute coordinates. modifiers hold the state of all keyboard modifiers at the time of the event.
Definition at line 1057 of file qevent.cpp.
|
inlineoverridevirtual |
Reimplemented from QPointerEvent.
|
inline |
Returns the previous position of the mouse cursor, relative to the widget that received the event.
If there is no previous position, oldPos() will return the same position as pos().
On QEvent::HoverEnter events, this position will always be QPoint(-1, -1).
|
inline |
Returns the previous position of the mouse cursor, relative to the widget that received the event.
If there is no previous position, oldPosF() will return the same position as posF().
On QEvent::HoverEnter events, this position will always be QPointF(-1, -1).
1.12.0