Enables simple pinch gesture handling. 更多...
| import 语句： | import QtQuick |
| 继承： |
The PinchArea type was added in QtQuick 1.1
A PinchArea is an invisible item that is typically used in conjunction with a visible item in order to provide pinch gesture handling for that item.
The enabled property is used to enable and disable pinch handling for the proxied item. When disabled, the pinch area becomes transparent to mouse/touch events.
PinchArea can be used in two ways:
pinch.target
to provide automatic interaction with an item
Since Qt 5.5, PinchArea can react to native pinch gesture events from the operating system if available; otherwise it reacts only to touch events.
另请参阅 PinchEvent , QNativeGestureEvent ，和 QTouchEvent .
|
enabled : bool |
This property holds whether the item accepts pinch gestures.
This property defaults to true.
|
pinch group |
|---|
|
pinch.active
:
bool
|
|
pinch.dragAxis : enumeration |
|
pinch.maximumRotation : real |
|
pinch.maximumScale : real |
|
pinch.maximumX : real |
|
pinch.maximumY : real |
|
pinch.minimumRotation : real |
|
pinch.minimumScale : real |
|
pinch.minimumX : real |
|
pinch.minimumY : real |
|
pinch.target : Item |
pinch
provides a convenient way to make an item react to pinch gestures.
pinch.target
specifies the id of the item to drag.
pinch.active
specifies if the target item is currently being dragged.
pinch.minimumScale
and
pinch.maximumScale
limit the range of the Item.scale property, but not the
PinchEvent
scale
特性。
pinch.minimumRotation
and
pinch.maximumRotation
limit the range of the Item.rotation property, but not the
PinchEvent
rotation
特性。
pinch.dragAxis
specifies whether dragging in not allowed (
Pinch.NoDrag
), can be done horizontally (
Pinch.XAxis
), vertically (
Pinch.YAxis
), or both (
Pinch.XAndYAxis
)
pinch.minimum
and
pinch.maximum
limit how far the target can be dragged along the corresponding axes.
|
pinchFinished ( PinchEvent pinch ) |
This signal is emitted when the pinch area detects that a pinch gesture has finished.
The pinch parameter (not the same as the pinch property) provides information about the pinch gesture, including the scale, center and angle of the pinch.
注意：
相应处理程序是
onPinchFinished
.
|
pinchStarted ( PinchEvent pinch ) |
This signal is emitted when the pinch area detects that a pinch gesture has started: two touch points (fingers) have been detected, and they have moved beyond the startDragDistance threshold for the gesture to begin.
The
pinch
parameter (not the same as the
pinch
property) provides information about the pinch gesture, including the scale, center and angle of the pinch. At the time of the
pinchStarted
signal, these values are reset to the default values, regardless of the results from previous gestures: pinch.scale will be
1.0
and pinch.rotation will be
0.0
. As the gesture progresses,
pinchUpdated
will report the deviation from those defaults.
要忽略此手势设置
pinch.accepted
property to false. The gesture will be canceled and no further events will be sent.
注意：
相应处理程序是
onPinchStarted
.
|
pinchUpdated ( PinchEvent pinch ) |
This signal is emitted when the pinch area detects that a pinch gesture has changed.
The pinch parameter provides information about the pinch gesture, including the scale, center and angle of the pinch. These values reflect changes only since the beginning of the current gesture, and therefore are not limited by the minimum and maximum limits in the pinch 特性。
注意：
相应处理程序是
onPinchUpdated
.
|
smartZoom ( PinchEvent pinch ) |
This signal is emitted when the pinch area detects a smart zoom gesture. This gesture occurs only on certain operating systems such as macOS.
The
pinch
parameter provides information about the pinch gesture, including the location where the gesture occurred.
pinch.scale
will be greater than zero when the gesture indicates that the user wishes to enter smart zoom, and zero when exiting (even though typically the same gesture is used to toggle between the two states).
注意：
相应处理程序是
onSmartZoom
.