鴻蒙ArkTS聲明式開發：跨平臺支持列表PinchGesture之基礎手勢

PinchGesture

用于觸發捏合手勢，觸發捏合手勢的最少手指為2指，最大為5指，最小識別距離為3vp。

說明：
開發前請熟悉鴻蒙開發指導文檔 ：[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md]
從API Version 7開始支持。后續版本如有新增內容，則采用上角標單獨標記該內容的起始版本。

接口

PinchGesture(value?: { fingers?: number, distance?: number })

參數：

參數名稱	參數類型	必填	參數描述
fingers	number	否	觸發捏合的最少手指數, 最小為2指，最大為5指。默認值：2
distance	number	否	最小識別距離，單位為vp。默認值：3說明：當識別距離的值小于等于0時，會被轉化為默認值。

事件

名稱	功能描述
onActionStart(event:(event?: [GestureEvent]) => void)	Pinch手勢識別成功回調。
onActionUpdate(event:(event?: [GestureEvent]) => void)	Pinch手勢移動過程中回調。
onActionEnd(event:(event?: [GestureEvent]) => void)	Pinch手勢識別成功，手指抬起后觸發回調。
onActionCancel(event: () => void)	Pinch手勢識別成功，接收到觸摸取消事件觸發回調。`HarmonyOS與OpenHarmony鴻蒙文檔籽料：mau123789是v直接拿`

示例

// xxx.ets
@Entry
@Component
struct PinchGestureExample {
  @State scaleValue: number = 1
  @State pinchValue: number = 1
  @State pinchX: number = 0
  @State pinchY: number = 0

  build() {
    Column() {
      Column() {
        Text('PinchGesture scale:n' + this.scaleValue)
        Text('PinchGesture center:n(' + this.pinchX + ',' + this.pinchY + ')')
      }
      .height(200)
      .width(300)
      .padding(20)
      .border({ width: 3 })
      .margin({ top: 100 })
      .scale({ x: this.scaleValue, y: this.scaleValue, z: 1 })
      // 三指捏合觸發該手勢事件
      .gesture(
      PinchGesture({ fingers: 3 })
        .onActionStart((event?: GestureEvent) = > {
          console.info('Pinch start')
        })
        .onActionUpdate((event?: GestureEvent) = > {
          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')
        })
      )
    }.width('100%')
  }
}