- class QHoverEvent#
The
QHoverEvent
class contains parameters that describe a mouse event. More…Synopsis#
Methods#
def
__init__()
def
oldPos()
def
oldPosF()
def
pos()
def
posF()
Note
This documentation may contain snippets that were automatically translated from C++ to Python. We always welcome contributions to the snippet translation. If you see an issue with the translation, you can also let us know by creating a ticket on https:/bugreports.qt.io/projects/PYSIDE
Detailed Description#
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:
A::MouseMove
B::MouseMove
C::MouseMove
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:
A::HoverMove
A::HoverMove, B::HoverMove
A::HoverMove, B::HoverMove, C::HoverMove
- __init__(type, pos, oldPos[, modifiers=Qt.NoModifier[, device=QPointingDevice.primaryPointingDevice()]])#
- Parameters:
type –
Type
pos –
QPointF
oldPos –
QPointF
modifiers – Combination of
KeyboardModifier
device –
QPointingDevice
Note
This function is deprecated.
Use the other constructor instead (global position is required).
Constructs a hover event object originating from
device
.The
type
parameter must be QEvent::HoverEnter, QEvent::HoverLeave, or QEvent::HoverMove.The
pos
is the current mouse cursor’s position relative to the receiving widget, whileoldPos
is its previous such position.modifiers
hold the state of all keyboard modifiers at the time of the event.- __init__(type, scenePos, globalPos, oldPos[, modifiers=Qt.NoModifier[, device=QPointingDevice.primaryPointingDevice()]])
- Parameters:
type –
Type
scenePos –
QPointF
globalPos –
QPointF
oldPos –
QPointF
modifiers – Combination of
KeyboardModifier
device –
QPointingDevice
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, andglobalPos
is the mouse position in absolute coordinates.modifiers
hold the state of all keyboard modifiers at the time of the event.- __init__(arg__1)
- Parameters:
arg__1 –
QHoverEvent
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).
See also
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).
See also
Use
position()
.toPoint() instead.Returns the position of the mouse cursor, relative to the widget that received the event.
On QEvent::HoverLeave events, this position will always be QPoint(-1, -1).
See also
Use
position()
instead.Returns the position of the mouse cursor, relative to the widget that received the event.
On QEvent::HoverLeave events, this position will always be QPointF(-1, -1).
See also