Qt
Internal/Contributor docs for the Qt SDK. Note: These are NOT official API docs; those are found at https://doc.qt.io/
Loading...
Searching...
No Matches
qquickdeliveryagent_p_p.h
Go to the documentation of this file.
1// Copyright (C) 2021 The Qt Company Ltd.
2// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR LGPL-3.0-only OR GPL-2.0-only OR GPL-3.0-only
3// Qt-Security score:significant reason:default
4
5#ifndef QQUICKDELIVERYAGENT_P_P_H
6#define QQUICKDELIVERYAGENT_P_P_H
7
8//
9// W A R N I N G
10// -------------
11//
12// This file is not part of the Qt API. It exists purely as an
13// implementation detail. This header file may change from version to
14// version without notice, or even be removed.
15//
16// We mean it.
17//
18
19#include <QtQuick/private/qquickdeliveryagent_p.h>
20#include <QtGui/qevent.h>
21#include <QtCore/qelapsedtimer.h>
22#include <QtCore/qstack.h>
23#include <QtCore/qxpfunctional.h>
24
25#include <private/qevent_p.h>
26#include <private/qpointingdevice_p.h>
27
28#include <QtCore/qpointer.h>
29#include <private/qobject_p.h>
30
31#include <memory>
32
33QT_BEGIN_NAMESPACE
34
35class QQuickDragGrabber;
36class QQuickItem;
37class QQuickPointerHandler;
38class QQuickWindow;
39
40/*! \internal
41 Extra device-specific data to be stored in QInputDevicePrivate::qqExtra.
42
43 \c deliveryTargets is a list of objects that have already been visited
44 during event delivery:
45 - QQuickPointerHandlerPrivate::deviceDeliveryTargets() returns the whole
46 list by reference
47 - QQuickPointerHandler::handlePointerEvent() appends to it
48 - QQuickItemPrivate::handlePointerEvent() checks it to prevent delivery to
49 the same handler multiple times
50*/
54
55class Q_QUICK_EXPORT QQuickDeliveryAgentPrivate : public QObjectPrivate
56{
57public:
58 Q_DECLARE_PUBLIC(QQuickDeliveryAgent)
59 QQuickDeliveryAgentPrivate(QQuickItem *root);
60 ~QQuickDeliveryAgentPrivate();
61
62 QQuickItem *rootItem = nullptr;
63
64 QQuickItem *activeFocusItem = nullptr;
65
66 void deliverKeyEvent(QKeyEvent *e);
67
68 enum FocusOption {
69 DontChangeFocusProperty = 0x01,
70 DontChangeSubFocusItem = 0x02
71 };
72 Q_DECLARE_FLAGS(FocusOptions, FocusOption)
73
74 void setFocusInScope(QQuickItem *scope, QQuickItem *item, Qt::FocusReason reason, FocusOptions = { });
75 void clearFocusInScope(QQuickItem *scope, QQuickItem *item, Qt::FocusReason reason, FocusOptions = { });
76 static void notifyFocusChangesRecur(QQuickItem **item, int remaining, Qt::FocusReason reason);
77 void clearFocusObject();
78 void updateFocusItemTransform();
79
80 QQuickItem *focusTargetItem() const;
81
82 // Keeps track of the item currently receiving mouse events
83#if QT_CONFIG(quick_draganddrop)
84 QQuickDragGrabber *dragGrabber = nullptr;
85#endif
86 QQuickItem *lastUngrabbed = nullptr;
87 QStack<QPointerEvent *> eventsInDelivery;
88 QFlatMap<QPointer<QQuickItem>, uint> hoverItems;
89 QList<QQuickItem *> hasFiltered; // during event delivery to a single receiver, the filtering parents for which childMouseEventFilter was already called
90 QList<QQuickItem *> skipDelivery; // during delivery of one event to all receivers, Items to which we know delivery is no longer necessary
91
92 std::unique_ptr<QMutableTouchEvent> delayedTouch;
93 QList<const QPointingDevice *> knownPointingDevices;
94
95 uint currentHoverId = 0;
96#if QT_CONFIG(wheelevent)
97 uint lastWheelEventAccepted = 0;
98#endif
99 uchar compressedTouchCount = 0;
100 bool allowChildEventFiltering = true;
101 bool hoveredLeafItemFound = false;
102
103 bool isSubsceneAgent = false;
104 static bool subsceneAgentsExist;
105 // QQuickDeliveryAgent::event() sets this to the one that's currently (trying to) handle the event
106 static QQuickDeliveryAgent *currentEventDeliveryAgent;
107 static QQuickDeliveryAgent *currentOrItemDeliveryAgent(const QQuickItem *item);
108 inline static quint64 frameSynchronousHover_counter = 0;
109
110 int frameSynchronousHoverInterval = 100; // milliseconds
111 QElapsedTimer frameSynchronousHoverTimer; // avoid calling deliverHoverEvent/updateCursor too often
112 QBasicTimer frameSynchronousDelayTimer; // call deliverHoverEvent/updateCursor after a delay
113
114 Qt::FocusReason lastFocusReason = Qt::OtherFocusReason;
115 int pointerEventRecursionGuard = 0;
116
117 int touchMouseId = -1; // only for obsolete stuff like QQuickItem::grabMouse()
118 // TODO get rid of these
119 const QPointingDevice *touchMouseDevice = nullptr;
120 ulong touchMousePressTimestamp = 0;
121 QPoint touchMousePressPos; // in screen coordinates
122
123 QQuickDeliveryAgent::Transform *sceneTransform = nullptr;
124
125 bool isDeliveringTouchAsMouse() const { return touchMouseId != -1 && touchMouseDevice; }
126 void cancelTouchMouseSynthesis();
127
128 bool checkIfDoubleTapped(ulong newPressEventTimestamp, const QPoint &newPressPos);
129 void resetIfDoubleTapPrevented(const QEventPoint &pressedPoint);
130 QPointingDevicePrivate::EventPointData *mousePointData();
131 QPointerEvent *eventInDelivery() const;
132
133 // Mouse positions are saved in widget coordinates
134 QPointF lastMousePosition;
135 bool deliverTouchAsMouse(QQuickItem *item, QTouchEvent *pointerEvent);
136 static void translateTouchEvent(QTouchEvent *touchEvent);
137 void removeGrabber(QQuickItem *grabber, bool mouse = true, bool touch = true, bool cancel = false);
138 void clearGrabbers(QPointerEvent *pointerEvent);
139 void onGrabChanged(QObject *grabber, QPointingDevice::GrabTransition transition, const QPointerEvent *event, const QEventPoint &point);
140 static QPointerEvent *clonePointerEvent(QPointerEvent *event, std::optional<QPointF> transformedLocalPos = std::nullopt);
141 void deliverToPassiveGrabbers(const QList<QPointer<QObject> > &passiveGrabbers, QPointerEvent *pointerEvent);
142 bool sendFilteredMouseEvent(QEvent *event, QQuickItem *receiver, QQuickItem *filteringParent);
143 bool sendFilteredPointerEvent(QPointerEvent *event, QQuickItem *receiver, QQuickItem *filteringParent = nullptr);
144 bool sendFilteredPointerEventImpl(QPointerEvent *event, QQuickItem *receiver, QQuickItem *filteringParent);
145 bool deliverSinglePointEventUntilAccepted(QPointerEvent *);
146
147 // entry point of events to the window
148 void handleTouchEvent(QTouchEvent *);
149 void handleMouseEvent(QMouseEvent *);
150 bool compressTouchEvent(QTouchEvent *);
151 void flushFrameSynchronousEvents(QQuickWindow *win);
152 void deliverDelayedTouchEvent();
153 void handleWindowDeactivate(QQuickWindow *win);
154 void handleWindowHidden(QQuickWindow *win);
155
156 // utility functions that used to be in QQuickPointerEvent et al.
157 bool allUpdatedPointsAccepted(const QPointerEvent *ev);
158 static void localizePointerEvent(QPointerEvent *ev, const QQuickItem *dest);
159 QList<QObject *> exclusiveGrabbers(QPointerEvent *ev);
160 static bool anyPointGrabbed(const QPointerEvent *ev);
161 static bool allPointsGrabbed(const QPointerEvent *ev);
162 static bool isMouseEvent(const QPointerEvent *ev);
163 static bool isMouseOrWheelEvent(const QPointerEvent *ev);
164 static bool isHoverEvent(const QPointerEvent *ev);
165 static bool isHoveringMoveEvent(const QPointerEvent *ev);
166 static bool isTouchEvent(const QPointerEvent *ev);
167 static bool isTabletEvent(const QPointerEvent *ev);
168 static bool isEventFromMouseOrTouchpad(const QPointerEvent *ev);
169 static bool isSynthMouse(const QPointerEvent *ev);
170 static bool isWithinDoubleClickInterval(ulong timeInterval);
171 static bool isWithinDoubleTapDistance(const QPoint &distanceBetweenPresses);
172 static bool isSinglePointDevice(const QInputDevice *dev);
173 static QQuickPointingDeviceExtra *deviceExtra(const QInputDevice *device);
174
175 // delivery of pointer events:
176 void touchToMouseEvent(QEvent::Type type, const QEventPoint &p, const QTouchEvent *touchEvent, QMutableSinglePointEvent *mouseEvent);
177 void ensureDeviceConnected(const QPointingDevice *dev);
178 void deliverPointerEvent(QPointerEvent *);
179 bool deliverTouchCancelEvent(QTouchEvent *);
180 bool deliverPressOrReleaseEvent(QPointerEvent *, bool handlersOnly = false);
181 void deliverUpdatedPoints(QPointerEvent *event);
182 void deliverMatchingPointsToItem(QQuickItem *item, bool isGrabber, QPointerEvent *pointerEvent, bool handlersOnly = false);
183
184 QList<QQuickItem *> eventTargets(QQuickItem *, const QEvent *event, int pointId, QPointF localPos, QPointF scenePos,
185 qxp::function_ref<std::optional<bool> (QQuickItem *, const QEvent *)> predicate) const;
186 QList<QQuickItem *> pointerTargets(QQuickItem *, const QPointerEvent *event, const QEventPoint &point,
187 bool checkMouseButtons, bool checkAcceptsTouch) const;
188 QList<QQuickItem *> mergePointerTargets(const QList<QQuickItem *> &list1, const QList<QQuickItem *> &list2) const;
189
190 // hover delivery
191 enum class HoverChange : uint8_t {
192 Clear,
193 Set,
194 };
195 bool deliverHoverEvent(const QPointF &scenePos, const QPointF &lastScenePos, Qt::KeyboardModifiers modifiers, ulong timestamp);
196 bool deliverHoverEventRecursive(QQuickItem *, const QPointF &localPos,
197 const QPointF &scenePos, const QPointF &lastScenePos,
198 const QPointF &globalPos, Qt::KeyboardModifiers modifiers, ulong timestamp);
199 bool deliverHoverEventToItem(QQuickItem *item, const QPointF &localPos, const QPointF &scenePos,
200 const QPointF &lastScenePos, const QPointF &globalPos,
201 Qt::KeyboardModifiers modifiers, ulong timestamp,
202 HoverChange hoverChange);
203 bool sendHoverEvent(QEvent::Type, QQuickItem *, const QPointF &localPos, const QPointF &scenePos,
204 const QPointF &lastScenePos, const QPointF &globalPos,
205 Qt::KeyboardModifiers modifiers, ulong timestamp);
206 bool clearHover(ulong timestamp = 0);
207
208#if QT_CONFIG(quick_draganddrop)
209 void deliverDragEvent(QQuickDragGrabber *, QEvent *);
210 bool deliverDragEvent(QQuickDragGrabber *, QQuickItem *, QDragMoveEvent *,
211 QVarLengthArray<QQuickItem *, 64> *currentGrabItems = nullptr,
212 QObject *formerTarget = nullptr);
213#endif
214
215 static bool dragOverThreshold(qreal d, Qt::Axis axis, QMouseEvent *event, int startDragThreshold = -1);
216
217 static bool dragOverThreshold(qreal d, Qt::Axis axis, const QEventPoint &tp, int startDragThreshold = -1);
218
219 static bool dragOverThreshold(QVector2D delta);
220
221 // context menu events
222 QList<QQuickItem *> contextMenuTargets(QQuickItem *item, const QContextMenuEvent *event) const;
223 void deliverContextMenuEvent(QContextMenuEvent *event);
224};
225
226Q_DECLARE_OPERATORS_FOR_FLAGS(QQuickDeliveryAgentPrivate::FocusOptions)
227
228QT_END_NAMESPACE
229
230#endif // QQUICKDELIVERYAGENT_P_P_H