PanGesture

用于觸發(fā)拖動手勢事件，滑動的最小距離為5vp時拖動手勢識別成功。

說明：
開發(fā)前請熟悉鴻蒙開發(fā)指導(dǎo)文檔 ：[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md]

從API Version 7開始支持。后續(xù)版本如有新增內(nèi)容，則采用上角標(biāo)單獨標(biāo)記該內(nèi)容的起始版本。

接口

PanGesture(value?: { fingers?: number; direction?: PanDirection; distance?: number } | [PanGestureOptions])

參數(shù)：

PanDirection枚舉說明

PanGestureOptions

通過PanGestureOptions對象接口可以動態(tài)修改滑動手勢識別器的屬性，從而避免通過狀態(tài)變量修改屬性（狀態(tài)變量修改會導(dǎo)致UI刷新）。

PanGestureOptions(value?: { fingers?: number; direction?: PanDirection; distance?: number })

參數(shù)：

接口

事件

示例

// xxx.ets
@Entry
@Component
struct PanGestureExample {
  @State offsetX: number = 0
  @State offsetY: number = 0
  @State positionX: number = 0
  @State positionY: number = 0
  private panOption: PanGestureOptions = new PanGestureOptions({ direction: PanDirection.Left | PanDirection.Right })

  build() {
    Column() {
      Column() {
        Text('PanGesture offset:nX: ' + this.offsetX + 'n' + 'Y: ' + this.offsetY)
      }
      .height(200)
      .width(300)
      .padding(20)
      .border({ width: 3 })
      .margin(50)
      .translate({ x: this.offsetX, y: this.offsetY, z: 0 }) // 以組件左上角為坐標(biāo)原點進行移動
      // 左右拖動觸發(fā)該手勢事件
      .gesture(
      PanGesture(this.panOption)
        .onActionStart((event?: GestureEvent) = > {
          console.info('Pan start')
        })
        .onActionUpdate((event?: GestureEvent) = > {
          if (event) {
            this.offsetX = this.positionX + event.offsetX
            this.offsetY = this.positionY + event.offsetY
          }
        })
        .onActionEnd(() = > {
          this.positionX = this.offsetX
          this.positionY = this.offsetY
          console.info('Pan end')
        })
      )

      Button('修改PanGesture觸發(fā)條件')
        .onClick(() = > {
          // 將PanGesture手勢事件觸發(fā)條件改為雙指以任意方向拖動
          this.panOption.setDirection(PanDirection.All)
          this.panOption.setFingers(2)
        })
    }
  }
}

`HarmonyOS與OpenHarmony鴻蒙文檔籽料：mau123789是v直接拿`

示意圖：

向左拖動：

點擊按鈕修改PanGesture觸發(fā)條件，雙指向左下方拖動：

審核編輯 黃宇