##HarmonyOS Next实战##HarmonyOS SDK应用服务##教育##
目标：通过两个手指捏合放大和缩小图片
知识点：
捏合手势（PinchGesture）用于触发捏合手势，触发捏合手势的最少手指为2指，最大为5指，最小识别距离为5vp。
接口
PinchGesture(value?:{fingers?:number, distance?:number})
捏合手势用于触发捏合手势事件，拥有两个可选参数：
- fingers：用于声明触发捏合手势所需要的最少手指数量，最小值为2，最大值为5，默认值为2。触发手势手指可以多于fingers数目，但只有先落下的与fingers相同数目的手指参与手势计算。
- distance：用于声明触发捏合手势的最小距离，单位为vp，默认值为5。说明：取值范围：[0, +∞)，当识别距离的值小于等于0时，会被转化为默认值。
API15新增：
isFingerCountLimited
是否检查触摸屏幕的手指数量。若触摸屏幕的手指数量不等于设置的触发捏合的最少手指数（即上述fingers参数），手势将不会被识别。只有当触摸屏幕的手指数等于设置的触发捏合手势的最小手指数，并且滑动距离满足阈值要求时，手势才能被成功识别（只有先落下的两根手指参与手势计算，若抬起其中的一个，手势识别失败）。对于已经成功识别的手势，后续改变触摸屏幕的手指数量，将不会触发onActionUpdate事件，但可以触发onActionEnd事件。默认值：false。
事件
onActionStart(event:(event: GestureEvent) => void) //Pinch手势识别成功回调。
onActionUpdate(event:(event: GestureEvent) => void) //Pinch手势移动过程中回调。
onActionEnd(event:(event: GestureEvent) => void) //Pinch手势识别成功，手指抬起后触发回调。
onActionCancel(event: () => void) //Pinch手势识别成功，接收到触摸取消事件触发回调。
属性
tag：设置Pinch手势标志，用于自定义手势判定时区分绑定的手势。
allowedTypes：设置Pinch手势支持的事件输入源。
实战：ImageEnlargementReductionDemoPage
@Entry
@Component
struct ImageEnlargementReductionDemoPage {
@State scaleValue: number = 1;
@State pinchValue: number = 1;
@State pinchX: number = 0;
@State pinchY: number = 0;
build() {
Stack({ alignContent: Alignment.Top }) {
Image('https://pica.zhimg.com/v2-764199c9470ff436082f35610f1f81f4_1440w.jpg')
.width('100%')
// 在组件上绑定缩放比例，可以通过修改缩放比例来实现组件的缩小或者放大
.scale({ x: this.scaleValue, y: this.scaleValue, z: 1 })
.gesture(
// 在组件上绑定2指触发的捏合手势
PinchGesture({ fingers: 2 })
.onActionStart((event: GestureEvent | undefined) => {
console.info('Pinch start');
})
// 当捏合手势触发时，可以通过回调函数获取缩放比例，从而修改组件的缩放比例
.onActionUpdate((event: GestureEvent | undefined) => {
if (event) {
this.scaleValue = this.pinchValue * event.scale;
this.pinchX = event.pinchCenterX;
this.pinchY = event.pinchCenterY;
}
})
.onActionEnd(() => {
this.pinchValue = this.scaleValue;
console.info('Pinch end');
})
)
Text('图片放大缩小Demo')
.fontColor(Color.Orange)
.fontSize(24)
}
.width('100%')
.height('100%')
}
}