PinchArea QML Type

PinchArea类型是在QtQuick 1.1中添加进去的.
PinchArea是一个不可见的对象,常用在与一个可见对象连接在一起,为对应的可见对象提供手势操作.
enabled属性被用来去设置绑定对象对应的手势触摸事件是否可用.当不可用时,手势触摸域就不会在对手势或者鼠标事件进行响应了.

PinchArea可以被用在两种方式下:

1.设置一个pinch.target去为对应绑定的对象提供自动接口.
2.使用onPinchStarted,onPinchUpdated,onPinchFinished.
可以参考 PinchEvent.

属性:

enabled : bool
这个属性保存了当前绑定的对象是否接受手势触摸操作.

这个属性默认值是true.
pinch
pinch.target : Item
pinch.active : bool
pinch.minimumScale : real
pinch.maximumScale : real
pinch.minimumRotation : real
pinch.maximumRotation : real
pinch.dragAxis : enumeration
pinch.minimumX : real
pinch.maximumX : real
pinch.minimumY : real
pinch.maximumY : real
pinch提供了一个方便的方式去使得绑定的可见对象对手势做出反应.
pinch.target指定了一个可见对象的Id去拖拽.
pinch.active 如果目标可见对象当前是被拖拽了的话,该值被指定.
pinch.minimumScale 和 pinch.maximumScale 限制了可见对象的范围,但是并不是手势事件的缩放属性.
pinch.minimumRotation 和 pinch.maximumRotation 限制了可见对象的范围.旋转属性,单不是手势事件的旋转属性.
pinch.dragAxis指定了是否拖拽是被允许的.可以是Pinch.XAxis,Pinch.YAxis,Pinch.XAndYAxis.
pinch.minimum和 pinch.maximum 限制了目标可以沿着坐标轴被拖拽多远.

信号:

pinchFinished()
当手势触摸域检测到一个手势已经完成是,该信号被发射出来.
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.
pinch参数(跟pinch的属性不一样)提供了关于手势的信息,包括缩放因子,中心点,以及角度.

通信句柄是onPinchFinished.

pinchStarted()
当手势触摸域检测到一个手势已经开始:两个触摸点已经被检测到了,并且两个手指已经移动离开了刚开始手指的位置,离开了一段距离,这个信号被发射出来.
pinch参数提供了关于触摸的相关参数(跟pinch属性不一样哟),包括缩放,中心点,以及触摸角度.pinchStarted信号发出的这一刻,这些值被重设成默认值,不管之前的手势结果:pinch.scale被设置为1.0,pinch.rotation被设置为0.0.手势过程中,pinchUpdated将报告从那些默认值出来的偏离值.
忽视手势,设置pinch.accepted属性为false.手势将被取消,并且没有进一步的事件被发送.

通信句柄是onPinchStarted.

pinchUpdated()
当触摸域检测到一个手势改变了时,这个信号被发射出来.
pinch参数提供了关于手势触摸的信息,包括缩放,中心点以及触摸角度.这些值反应了当且仅当开始当前手势时的改变,因此是不会被minimum和maximum限制了触摸属性的.

通信句柄是onPinchUpdated.