![]() |
Qt
Internal/Contributor docs for the Qt SDK. Note: These are NOT official API docs; those are found at https://doc.qt.io/
|
A base class for pointer events containing a single point, such as mouse events. More...
#include <qevent.h>
Public Member Functions | |
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) |
![]() | |
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. | |
![]() | |
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. | |
![]() | |
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 Member Functions | |
QSinglePointEvent (Type type, const QPointingDevice *dev, const QEventPoint &point, Qt::MouseButton button, Qt::MouseButtons buttons, Qt::KeyboardModifiers modifiers, Qt::MouseEventSource source) | |
QSinglePointEvent (Type type, const QPointingDevice *dev, const QPointF &localPos, const QPointF &scenePos, const QPointF &globalPos, Qt::MouseButton button, Qt::MouseButtons buttons, Qt::KeyboardModifiers modifiers, Qt::MouseEventSource source=Qt::MouseEventNotSynthesized) | |
![]() | |
QPointerEvent (Type type, SinglePointEventTag, const QInputDevice *dev, Qt::KeyboardModifiers modifiers=Qt::NoModifier) | |
![]() | |
QInputEvent (Type type, PointerEventTag, const QInputDevice *dev, Qt::KeyboardModifiers modifiers=Qt::NoModifier) | |
QInputEvent (Type type, SinglePointEventTag, const QInputDevice *dev, Qt::KeyboardModifiers modifiers=Qt::NoModifier) | |
![]() | |
QT_DEFINE_TAG_STRUCT (InputEventTag) | |
QEvent (Type type, InputEventTag) | |
QT_DEFINE_TAG_STRUCT (PointerEventTag) | |
QEvent (Type type, PointerEventTag) | |
QT_DEFINE_TAG_STRUCT (SinglePointEventTag) | |
QEvent (Type type, SinglePointEventTag) | |
Protected Attributes | |
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 |
![]() | |
QList< QEventPoint > | m_points |
![]() | |
const QInputDevice * | m_dev = nullptr |
quint64 | m_timeStamp = 0 |
Qt::KeyboardModifiers | m_modState = Qt::NoModifier |
quint32 | m_reserved = 0 |
![]() | |
quint16 | t |
Properties | |
QObject * | exclusivePointGrabber |
the object that will receive future updates | |
Friends | |
class | ::tst_QEvent |
class | QMutableSinglePointEvent |
A base class for pointer events containing a single point, such as mouse events.
|
protected |
|
protected |
|
inline |
Returns the button that caused the event.
The returned value is always Qt::NoButton for mouse move events, as well as \l TabletMove, \l TabletEnterProximity, and \l TabletLeaveProximity events.
|
inline |
Returns the button state when the event was generated.
The button state is a combination of Qt::LeftButton, Qt::RightButton, and Qt::MiddleButton using the OR operator.
For mouse move or \l TabletMove events, this is all buttons that are pressed down.
For mouse press, double click, or \l TabletPress events, this includes the button that caused the event.
For mouse release or \l TabletRelease events, this excludes the button that caused the event.
|
inline |
|
inline |
Returns the position of the point in this event on the screen or virtual desktop.
|
overridevirtual |
Returns true
if this event represents a \l {button()}{button} being pressed.
Reimplemented from QPointerEvent.
Definition at line 582 of file qevent.cpp.
|
overridevirtual |
Returns true
if this event represents a \l {button()}{button} being released.
Reimplemented from QPointerEvent.
Definition at line 604 of file qevent.cpp.
|
overridevirtual |
Returns true
if this event does not include a change in \l {buttons()}{button state}.
Reimplemented from QPointerEvent.
Definition at line 594 of file qevent.cpp.
|
inline |
Returns the position of the point in this event, relative to the widget or item that received the event.
If you move your widgets around in response to mouse events, use globalPosition() instead.
|
inline |
Returns the position of the point in this event, relative to the window or scene.
|
friend |
|
protected |
|
protected |
|
protected |
|
readwrite |
the object that will receive future updates
The exclusive grabber is an object that has chosen to receive all future update events and the release event containing the same point that this event carries.
Setting the exclusivePointGrabber property is a convenience equivalent to: