触发捏合手势

2024-01-22 16:49 更新

用于触发捏合手势,触发捏合手势的最少手指为2指,最大为5指,最小识别距离为5vp。

说明

从API Version 7开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。

接口

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

参数:

参数名称

参数类型

必填

参数描述

fingers

number

触发捏合的最少手指数, 最小为2指,最大为5指。

默认值:2

distance

number

最小识别距离,单位为vp。

默认值:5

事件

名称

功能描述

onActionStart(event:(event?: GestureEvent) => void)

Pinch手势识别成功回调。

onActionUpdate(event:(event?: GestureEvent) => void)

Pinch手势移动过程中回调。

onActionEnd(event:(event?: GestureEvent) => void)

Pinch手势识别成功,手指抬起后触发回调。

onActionCancel(event: () => void)

Pinch手势识别成功,接收到触摸取消事件触发回调。

示例

  1. // xxx.ets
  2. @Entry
  3. @Component
  4. struct PinchGestureExample {
  5. @State scaleValue: number = 1
  6. @State pinchValue: number = 1
  7. @State pinchX: number = 0
  8. @State pinchY: number = 0
  9. build() {
  10. Column() {
  11. Column() {
  12. Text('PinchGesture scale:\n' + this.scaleValue)
  13. Text('PinchGesture center:\n(' + this.pinchX + ',' + this.pinchY + ')')
  14. }
  15. .height(200)
  16. .width(300)
  17. .padding(20)
  18. .border({ width: 3 })
  19. .margin({ top: 100 })
  20. .scale({ x: this.scaleValue, y: this.scaleValue, z: 1 })
  21. // 三指捏合触发该手势事件
  22. .gesture(
  23. PinchGesture({ fingers: 3 })
  24. .onActionStart((event: GestureEvent) => {
  25. console.info('Pinch start')
  26. })
  27. .onActionUpdate((event: GestureEvent) => {
  28. this.scaleValue = this.pinchValue * event.scale
  29. this.pinchX = event.pinchCenterX
  30. this.pinchY = event.pinchCenterY
  31. })
  32. .onActionEnd(() => {
  33. this.pinchValue = this.scaleValue
  34. console.info('Pinch end')
  35. })
  36. )
  37. }.width('100%')
  38. }
  39. }

以上内容是否对您有帮助:
在线笔记
App下载
App下载

扫描二维码

下载编程狮App

公众号
微信公众号

编程狮公众号