DragHandler QML Type
Handler for dragging. More...
Import Statement: | import QtQuick 2.12 |
Inherits: |
Properties
- translation : QVector2D
- xAxis
- xAxis.minimum : real
- xAxis.maximum : real
- xAxis.enabled : bool
- yAxis
- yAxis.minimum : real
- yAxis.maximum : real
- yAxis.enabled : bool
Detailed Description
DragHandler is a handler that is used to interactively move an Item. Like other Input Handlers, by default it is fully functional, and manipulates its target.
import QtQuick 2.12 Rectangle { width: 100 height: 100 color: "lightsteelblue" DragHandler { } }
It has properties to restrict the range of dragging.
If it is declared within one Item but is assigned a different target, then it handles events within the bounds of the parent Item but manipulates the target
Item instead:
import QtQuick 2.12 Item { width: 640 height: 480 Rectangle { id: feedback border.color: "red" width: Math.max(10, handler.centroid.ellipseDiameters.width) height: Math.max(10, handler.centroid.ellipseDiameters.height) radius: Math.max(width, height) / 2 visible: handler.active } DragHandler { id: handler target: feedback } }
A third way to use it is to set target to null
and react to property changes in some other way:
import QtQuick 2.12 Item { width: 640 height: 480 DragHandler { id: handler target: null } Text { color: handler.active ? "darkgreen" : "black" text: handler.centroid.centroid.x.toFixed(1) + "," + handler.centroid.position.y.toFixed(1) x: handler.centroid.position.x - width / 2 y: handler.centroid.position.y - height } }
If minimumPointCount and maximumPointCount are set to values larger than 1, the user will need to drag that many fingers in the same direction to start dragging. A multi-finger drag gesture can be detected independently of both a (default) single-finger DragHandler and a PinchHandler on the same Item, and thus can be used to adjust some other feature independently of the usual pinch behavior: for example adjust a tilt transformation, or adjust some other numeric value, if the target
is set to null. But if the target
is an Item, centroid
is the point at which the drag begins and to which the target
will be moved (subject to constraints).
At this time, drag-and-drop is not yet supported.
Property Documentation
© 2019 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.