PanGesture

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

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

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

接口

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

參數(shù)：

PanDirection枚舉說(shuō)明

PanGestureOptions

通過(guò)PanGestureOptions對(duì)象接口可以動(dòng)態(tài)修改滑動(dòng)手勢(shì)識(shí)別器的屬性，從而避免通過(guò)狀態(tài)變量修改屬性（狀態(tài)變量修改會(huì)導(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)原點(diǎn)進(jìn)行移動(dòng)
      // 左右拖動(dòng)觸發(fā)該手勢(shì)事件
      .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手勢(shì)事件觸發(fā)條件改為雙指以任意方向拖動(dòng)
          this.panOption.setDirection(PanDirection.All)
          this.panOption.setFingers(2)
        })
    }
  }
}

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

示意圖：

向左拖動(dòng)：

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

審核編輯 黃宇