| Absolute File Name: | /home/opencoverage/opencoverage/guest-scripts/qtdeclarative/src/qtdeclarative/src/quick/handlers/qquickpointerdevicehandler.cpp |
| Source code | Switch to Preprocessed file |
| Line | Source | Count | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 1 | /**************************************************************************** | - | ||||||||||||
| 2 | ** | - | ||||||||||||
| 3 | ** Copyright (C) 2016 The Qt Company Ltd. | - | ||||||||||||
| 4 | ** Contact: https://www.qt.io/licensing/ | - | ||||||||||||
| 5 | ** | - | ||||||||||||
| 6 | ** This file is part of the QtQuick module of the Qt Toolkit. | - | ||||||||||||
| 7 | ** | - | ||||||||||||
| 8 | ** $QT_BEGIN_LICENSE:LGPL$ | - | ||||||||||||
| 9 | ** Commercial License Usage | - | ||||||||||||
| 10 | ** Licensees holding valid commercial Qt licenses may use this file in | - | ||||||||||||
| 11 | ** accordance with the commercial license agreement provided with the | - | ||||||||||||
| 12 | ** Software or, alternatively, in accordance with the terms contained in | - | ||||||||||||
| 13 | ** a written agreement between you and The Qt Company. For licensing terms | - | ||||||||||||
| 14 | ** and conditions see https://www.qt.io/terms-conditions. For further | - | ||||||||||||
| 15 | ** information use the contact form at https://www.qt.io/contact-us. | - | ||||||||||||
| 16 | ** | - | ||||||||||||
| 17 | ** GNU Lesser General Public License Usage | - | ||||||||||||
| 18 | ** Alternatively, this file may be used under the terms of the GNU Lesser | - | ||||||||||||
| 19 | ** General Public License version 3 as published by the Free Software | - | ||||||||||||
| 20 | ** Foundation and appearing in the file LICENSE.LGPL3 included in the | - | ||||||||||||
| 21 | ** packaging of this file. Please review the following information to | - | ||||||||||||
| 22 | ** ensure the GNU Lesser General Public License version 3 requirements | - | ||||||||||||
| 23 | ** will be met: https://www.gnu.org/licenses/lgpl-3.0.html. | - | ||||||||||||
| 24 | ** | - | ||||||||||||
| 25 | ** GNU General Public License Usage | - | ||||||||||||
| 26 | ** Alternatively, this file may be used under the terms of the GNU | - | ||||||||||||
| 27 | ** General Public License version 2.0 or (at your option) the GNU General | - | ||||||||||||
| 28 | ** Public license version 3 or any later version approved by the KDE Free | - | ||||||||||||
| 29 | ** Qt Foundation. The licenses are as published by the Free Software | - | ||||||||||||
| 30 | ** Foundation and appearing in the file LICENSE.GPL2 and LICENSE.GPL3 | - | ||||||||||||
| 31 | ** included in the packaging of this file. Please review the following | - | ||||||||||||
| 32 | ** information to ensure the GNU General Public License requirements will | - | ||||||||||||
| 33 | ** be met: https://www.gnu.org/licenses/gpl-2.0.html and | - | ||||||||||||
| 34 | ** https://www.gnu.org/licenses/gpl-3.0.html. | - | ||||||||||||
| 35 | ** | - | ||||||||||||
| 36 | ** $QT_END_LICENSE$ | - | ||||||||||||
| 37 | ** | - | ||||||||||||
| 38 | ****************************************************************************/ | - | ||||||||||||
| 39 | - | |||||||||||||
| 40 | #include "qquickpointerdevicehandler_p_p.h" | - | ||||||||||||
| 41 | #include <private/qquickitem_p.h> | - | ||||||||||||
| 42 | #include <QMouseEvent> | - | ||||||||||||
| 43 | #include <QDebug> | - | ||||||||||||
| 44 | - | |||||||||||||
| 45 | QT_BEGIN_NAMESPACE | - | ||||||||||||
| 46 | - | |||||||||||||
| 47 | /*! | - | ||||||||||||
| 48 | \qmltype PointerDeviceHandler | - | ||||||||||||
| 49 | \qmlabstract | - | ||||||||||||
| 50 | \since 5.10 | - | ||||||||||||
| 51 | \preliminary | - | ||||||||||||
| 52 | \instantiates QQuickPointerDeviceHandler | - | ||||||||||||
| 53 | \inherits PointerHandler | - | ||||||||||||
| 54 | \inqmlmodule Qt.labs.handlers | - | ||||||||||||
| 55 | \ingroup qtquick-handlers | - | ||||||||||||
| 56 | \brief Abstract handler for pointer events with device-specific constraints. | - | ||||||||||||
| 57 | - | |||||||||||||
| 58 | An intermediate class (not registered as a QML type) for handlers which | - | ||||||||||||
| 59 | allow filtering based on device type, pointer type, or keyboard modifiers. | - | ||||||||||||
| 60 | */ | - | ||||||||||||
| 61 | QQuickPointerDeviceHandler::QQuickPointerDeviceHandler(QObject *parent) | - | ||||||||||||
| 62 | : QQuickPointerHandler(*(new QQuickPointerDeviceHandlerPrivate), parent) | - | ||||||||||||
| 63 | { | - | ||||||||||||
| 64 | } executed 1004 times by 5 tests: end of blockExecuted by:
| 1004 | ||||||||||||
| 65 | - | |||||||||||||
| 66 | QQuickPointerDeviceHandler::QQuickPointerDeviceHandler(QQuickPointerDeviceHandlerPrivate &dd, QObject *parent) | - | ||||||||||||
| 67 | : QQuickPointerHandler(dd, parent) | - | ||||||||||||
| 68 | { | - | ||||||||||||
| 69 | } never executed: end of block | 0 | ||||||||||||
| 70 | - | |||||||||||||
| 71 | QQuickPointerDeviceHandler::~QQuickPointerDeviceHandler() | - | ||||||||||||
| 72 | { | - | ||||||||||||
| 73 | } | - | ||||||||||||
| 74 | - | |||||||||||||
| 75 | QQuickPointerDevice::DeviceTypes QQuickPointerDeviceHandler::acceptedDevices() const | - | ||||||||||||
| 76 | { | - | ||||||||||||
| 77 | Q_D(const QQuickPointerDeviceHandler); | - | ||||||||||||
| 78 | return d->acceptedDevices; never executed: return d->acceptedDevices; | 0 | ||||||||||||
| 79 | } | - | ||||||||||||
| 80 | - | |||||||||||||
| 81 | QQuickPointerDevice::PointerTypes QQuickPointerDeviceHandler::acceptedPointerTypes() const | - | ||||||||||||
| 82 | { | - | ||||||||||||
| 83 | Q_D(const QQuickPointerDeviceHandler); | - | ||||||||||||
| 84 | return d->acceptedPointerTypes; never executed: return d->acceptedPointerTypes; | 0 | ||||||||||||
| 85 | } | - | ||||||||||||
| 86 | - | |||||||||||||
| 87 | /*! | - | ||||||||||||
| 88 | \qmlproperty int QtQuick::PointerDeviceHandler::acceptedButtons | - | ||||||||||||
| 89 | - | |||||||||||||
| 90 | The mouse buttons which can activate this Pointer Handler. | - | ||||||||||||
| 91 | - | |||||||||||||
| 92 | By default, this property is set to \l {QtQuick::MouseEvent::button} {Qt.LeftButton}. | - | ||||||||||||
| 93 | It can be set to an OR combination of mouse buttons, and will ignore events | - | ||||||||||||
| 94 | from other buttons. | - | ||||||||||||
| 95 | - | |||||||||||||
| 96 | For example, a control could be made to respond to left and right clicks | - | ||||||||||||
| 97 | in different ways, with two handlers: | - | ||||||||||||
| 98 | - | |||||||||||||
| 99 | \qml | - | ||||||||||||
| 100 | Item { | - | ||||||||||||
| 101 | TapHandler { | - | ||||||||||||
| 102 | onTapped: console.log("left clicked") | - | ||||||||||||
| 103 | } | - | ||||||||||||
| 104 | TapHandler { | - | ||||||||||||
| 105 | acceptedButtons: Qt.RightButton | - | ||||||||||||
| 106 | onTapped: console.log("right clicked") | - | ||||||||||||
| 107 | } | - | ||||||||||||
| 108 | } | - | ||||||||||||
| 109 | \endqml | - | ||||||||||||
| 110 | - | |||||||||||||
| 111 | \note Tapping on a touchscreen or tapping the stylus on a graphics tablet | - | ||||||||||||
| 112 | emulates clicking the left mouse button. This behavior can be altered via | - | ||||||||||||
| 113 | \l {PointerDeviceHandler::acceptedDevices}{acceptedDevices} or | - | ||||||||||||
| 114 | \l {PointerDeviceHandler::acceptedPointerTypes}{acceptedPointerTypes}. | - | ||||||||||||
| 115 | */ | - | ||||||||||||
| 116 | Qt::MouseButtons QQuickPointerDeviceHandler::acceptedButtons() const | - | ||||||||||||
| 117 | { | - | ||||||||||||
| 118 | Q_D(const QQuickPointerDeviceHandler); | - | ||||||||||||
| 119 | return d->acceptedButtons; executed 490 times by 3 tests: return d->acceptedButtons;Executed by:
| 490 | ||||||||||||
| 120 | } | - | ||||||||||||
| 121 | - | |||||||||||||
| 122 | void QQuickPointerDeviceHandler::setAcceptedButtons(Qt::MouseButtons buttons) | - | ||||||||||||
| 123 | { | - | ||||||||||||
| 124 | Q_D(QQuickPointerDeviceHandler); | - | ||||||||||||
| 125 | if (d->acceptedButtons == buttons)
| 0 | ||||||||||||
| 126 | return; never executed: return; | 0 | ||||||||||||
| 127 | - | |||||||||||||
| 128 | d->acceptedButtons = buttons; | - | ||||||||||||
| 129 | emit acceptedButtonsChanged(); | - | ||||||||||||
| 130 | } never executed: end of block | 0 | ||||||||||||
| 131 | - | |||||||||||||
| 132 | Qt::KeyboardModifiers QQuickPointerDeviceHandler::acceptedModifiers() const | - | ||||||||||||
| 133 | { | - | ||||||||||||
| 134 | Q_D(const QQuickPointerDeviceHandler); | - | ||||||||||||
| 135 | return d->acceptedModifiers; never executed: return d->acceptedModifiers; | 0 | ||||||||||||
| 136 | } | - | ||||||||||||
| 137 | - | |||||||||||||
| 138 | /*! | - | ||||||||||||
| 139 | \qmlproperty int PointerDeviceHandler::acceptedDevices | - | ||||||||||||
| 140 | - | |||||||||||||
| 141 | The types of pointing devices that can activate this Pointer Handler. | - | ||||||||||||
| 142 | - | |||||||||||||
| 143 | By default, this property is set to | - | ||||||||||||
| 144 | \l{QtQuick::PointerDevice::type} {PointerDevice.AllDevices}. | - | ||||||||||||
| 145 | If you set it to an OR combination of device types, it will ignore events | - | ||||||||||||
| 146 | from non-matching devices. | - | ||||||||||||
| 147 | - | |||||||||||||
| 148 | For example, a control could be made to respond to mouse and stylus clicks | - | ||||||||||||
| 149 | in one way, and touchscreen taps in another way, with two handlers: | - | ||||||||||||
| 150 | - | |||||||||||||
| 151 | \qml | - | ||||||||||||
| 152 | Item { | - | ||||||||||||
| 153 | TapHandler { | - | ||||||||||||
| 154 | acceptedDevices: PointerDevice.Mouse | PointerDevice.Stylus | - | ||||||||||||
| 155 | onTapped: console.log("clicked") | - | ||||||||||||
| 156 | } | - | ||||||||||||
| 157 | TapHandler { | - | ||||||||||||
| 158 | acceptedDevices: PointerDevice.TouchScreen | - | ||||||||||||
| 159 | onTapped: console.log("tapped") | - | ||||||||||||
| 160 | } | - | ||||||||||||
| 161 | } | - | ||||||||||||
| 162 | \endqml | - | ||||||||||||
| 163 | */ | - | ||||||||||||
| 164 | void QQuickPointerDeviceHandler::setAcceptedDevices(QQuickPointerDevice::DeviceTypes acceptedDevices) | - | ||||||||||||
| 165 | { | - | ||||||||||||
| 166 | Q_D(QQuickPointerDeviceHandler); | - | ||||||||||||
| 167 | if (d->acceptedDevices == acceptedDevices)
| 0 | ||||||||||||
| 168 | return; never executed: return; | 0 | ||||||||||||
| 169 | - | |||||||||||||
| 170 | d->acceptedDevices = acceptedDevices; | - | ||||||||||||
| 171 | emit acceptedDevicesChanged(); | - | ||||||||||||
| 172 | } never executed: end of block | 0 | ||||||||||||
| 173 | - | |||||||||||||
| 174 | /*! | - | ||||||||||||
| 175 | \qmlproperty int PointerDeviceHandler::acceptedPointerTypes | - | ||||||||||||
| 176 | - | |||||||||||||
| 177 | The types of pointing instruments (finger, stylus, eraser, etc.) | - | ||||||||||||
| 178 | that can activate this Pointer Handler. | - | ||||||||||||
| 179 | - | |||||||||||||
| 180 | By default, this property is set to | - | ||||||||||||
| 181 | \l {QtQuick::PointerDevice::pointerType} {PointerDevice.AllPointerTypes}. | - | ||||||||||||
| 182 | If you set it to an OR combination of device types, it will ignore events | - | ||||||||||||
| 183 | from non-matching events. | - | ||||||||||||
| 184 | - | |||||||||||||
| 185 | For example, a control could be made to respond to mouse, touch, and stylus clicks | - | ||||||||||||
| 186 | in some way, but delete itself if tapped with an eraser tool on a graphics tablet, | - | ||||||||||||
| 187 | with two handlers: | - | ||||||||||||
| 188 | - | |||||||||||||
| 189 | \qml | - | ||||||||||||
| 190 | Rectangle { | - | ||||||||||||
| 191 | id: rect | - | ||||||||||||
| 192 | TapHandler { | - | ||||||||||||
| 193 | acceptedPointerTypes: PointerDevice.GenericPointer | PointerDevice.Finger | PointerDevice.Pen | - | ||||||||||||
| 194 | onTapped: console.log("clicked") | - | ||||||||||||
| 195 | } | - | ||||||||||||
| 196 | TapHandler { | - | ||||||||||||
| 197 | acceptedPointerTypes: PointerDevice.Eraser | - | ||||||||||||
| 198 | onTapped: rect.destroy() | - | ||||||||||||
| 199 | } | - | ||||||||||||
| 200 | } | - | ||||||||||||
| 201 | \endqml | - | ||||||||||||
| 202 | */ | - | ||||||||||||
| 203 | void QQuickPointerDeviceHandler::setAcceptedPointerTypes(QQuickPointerDevice::PointerTypes acceptedPointerTypes) | - | ||||||||||||
| 204 | { | - | ||||||||||||
| 205 | Q_D(QQuickPointerDeviceHandler); | - | ||||||||||||
| 206 | if (d->acceptedPointerTypes == acceptedPointerTypes)
| 0 | ||||||||||||
| 207 | return; never executed: return; | 0 | ||||||||||||
| 208 | - | |||||||||||||
| 209 | d->acceptedPointerTypes = acceptedPointerTypes; | - | ||||||||||||
| 210 | emit acceptedPointerTypesChanged(); | - | ||||||||||||
| 211 | } never executed: end of block | 0 | ||||||||||||
| 212 | - | |||||||||||||
| 213 | /*! | - | ||||||||||||
| 214 | \qmlproperty int PointerDeviceHandler::acceptedModifiers | - | ||||||||||||
| 215 | - | |||||||||||||
| 216 | If this property is set, it will require the given keyboard modifiers to | - | ||||||||||||
| 217 | be pressed in order to react to pointer events, and otherwise ignore them. | - | ||||||||||||
| 218 | - | |||||||||||||
| 219 | If this property is set to \c Qt.KeyboardModifierMask (the default value), | - | ||||||||||||
| 220 | then the PointerHandler ignores the modifier keys. | - | ||||||||||||
| 221 | - | |||||||||||||
| 222 | For example, an \l [QML] Item could have two handlers of the same type, | - | ||||||||||||
| 223 | one of which is enabled only if the required keyboard modifiers are | - | ||||||||||||
| 224 | pressed: | - | ||||||||||||
| 225 | - | |||||||||||||
| 226 | \qml | - | ||||||||||||
| 227 | Item { | - | ||||||||||||
| 228 | TapHandler { | - | ||||||||||||
| 229 | acceptedModifiers: Qt.ControlModifier | - | ||||||||||||
| 230 | onTapped: console.log("control-tapped") | - | ||||||||||||
| 231 | } | - | ||||||||||||
| 232 | TapHandler { | - | ||||||||||||
| 233 | acceptedModifiers: Qt.NoModifier | - | ||||||||||||
| 234 | onTapped: console.log("tapped") | - | ||||||||||||
| 235 | } | - | ||||||||||||
| 236 | } | - | ||||||||||||
| 237 | \endqml | - | ||||||||||||
| 238 | */ | - | ||||||||||||
| 239 | void QQuickPointerDeviceHandler::setAcceptedModifiers(Qt::KeyboardModifiers acceptedModifiers) | - | ||||||||||||
| 240 | { | - | ||||||||||||
| 241 | Q_D(QQuickPointerDeviceHandler); | - | ||||||||||||
| 242 | if (d->acceptedModifiers == acceptedModifiers)
| 0 | ||||||||||||
| 243 | return; never executed: return; | 0 | ||||||||||||
| 244 | - | |||||||||||||
| 245 | d->acceptedModifiers = acceptedModifiers; | - | ||||||||||||
| 246 | emit acceptedModifiersChanged(); | - | ||||||||||||
| 247 | } never executed: end of block | 0 | ||||||||||||
| 248 | - | |||||||||||||
| 249 | bool QQuickPointerDeviceHandler::wantsPointerEvent(QQuickPointerEvent *event) | - | ||||||||||||
| 250 | { | - | ||||||||||||
| 251 | Q_D(QQuickPointerDeviceHandler); | - | ||||||||||||
| 252 | if (!QQuickPointerHandler::wantsPointerEvent(event))
| 0-2688 | ||||||||||||
| 253 | return false; never executed: return false; | 0 | ||||||||||||
| 254 | qCDebug(lcPointerHandlerDispatch) << objectName() never executed: QMessageLogger(__FILE__, 254, __PRETTY_FUNCTION__, lcPointerHandlerDispatch().categoryName()).debug() << objectName() << "checking device type" << d->acceptedDevices << "pointer type" << d->acceptedPointerTypes << "modifiers" << d->acceptedModifiers;
| 0-2688 | ||||||||||||
| 255 | << "checking device type" << d->acceptedDevices never executed: QMessageLogger(__FILE__, 254, __PRETTY_FUNCTION__, lcPointerHandlerDispatch().categoryName()).debug() << objectName() << "checking device type" << d->acceptedDevices << "pointer type" << d->acceptedPointerTypes << "modifiers" << d->acceptedModifiers; | 0 | ||||||||||||
| 256 | << "pointer type" << d->acceptedPointerTypes never executed: QMessageLogger(__FILE__, 254, __PRETTY_FUNCTION__, lcPointerHandlerDispatch().categoryName()).debug() << objectName() << "checking device type" << d->acceptedDevices << "pointer type" << d->acceptedPointerTypes << "modifiers" << d->acceptedModifiers; | 0 | ||||||||||||
| 257 | << "modifiers" << d->acceptedModifiers; never executed: QMessageLogger(__FILE__, 254, __PRETTY_FUNCTION__, lcPointerHandlerDispatch().categoryName()).debug() << objectName() << "checking device type" << d->acceptedDevices << "pointer type" << d->acceptedPointerTypes << "modifiers" << d->acceptedModifiers; | 0 | ||||||||||||
| 258 | if ((event->device()->type() & d->acceptedDevices) == 0)
| 0-2688 | ||||||||||||
| 259 | return false; never executed: return false; | 0 | ||||||||||||
| 260 | if ((event->device()->pointerType() & d->acceptedPointerTypes) == 0)
| 0-2688 | ||||||||||||
| 261 | return false; never executed: return false; | 0 | ||||||||||||
| 262 | if (d->acceptedModifiers != Qt::KeyboardModifierMask && event->modifiers() != d->acceptedModifiers)
| 0-2688 | ||||||||||||
| 263 | return false; never executed: return false; | 0 | ||||||||||||
| 264 | return true; executed 2688 times by 4 tests: return true;Executed by:
| 2688 | ||||||||||||
| 265 | } | - | ||||||||||||
| 266 | - | |||||||||||||
| 267 | QT_END_NAMESPACE | - | ||||||||||||
| Source code | Switch to Preprocessed file |