單一手勢

TapGesture(value?:{count?:number; fingers?:number})

點擊手勢支持單次點擊和多次點擊，擁有兩個可選參數(shù)：

• count：非必填參數(shù)，聲明該點擊手勢識別的連續(xù)點擊次數(shù)。默認值為1，若設(shè)置小于1的非法值會被轉(zhuǎn)化為默認值。如果配置多次點擊，上一次抬起和下一次按下的超時時間為300毫秒。
• fingers：非必填參數(shù)，用于聲明觸發(fā)點擊的手指數(shù)量，最小值為1，最大值為10，默認值為1。當(dāng)配置多指時，若第一根手指按下300毫秒內(nèi)未有足夠的手指數(shù)按下則手勢識別失敗。當(dāng)實際點擊手指數(shù)超過配置值時，手勢識別失敗。
  以在Text組件上綁定雙擊手勢（count值為2的點擊手勢）為例：

  // xxx.ets
  @Entry
  @Component
  struct Index {
    @State value: string = "";
    
    build() {
      Column() {
        Text('Click twice').fontSize(28)
          .gesture(
            // 綁定count為2的TapGesture
            TapGesture({ count: 2 })
              .onAction((event: GestureEvent) => {
                this.value = JSON.stringify(event.fingerList[0]);
              }))
        Text(this.value)
      }
      .height(200)
      .width(250)
      .padding(20)
      .border({ width: 3 })
      .margin(30)
    }
  }

  

LongPressGesture(value?:{fingers?:number; repeat?:boolean; duration?:number})

長按手勢用于觸發(fā)長按手勢事件，觸發(fā)長按手勢的最少手指數(shù)量為1，最短長按事件為500毫秒，擁有三個可選參數(shù)：

• fingers：非必選參數(shù)，用于聲明觸發(fā)長按手勢所需要的最少手指數(shù)量，最小值為1，最大值為10，默認值為1。
• repeat：非必選參數(shù)，用于聲明是否連續(xù)觸發(fā)事件回調(diào)，默認值為false。
• duration：非必選參數(shù)，用于聲明觸發(fā)長按所需的最短時間，單位為毫秒，默認值為500。

以在Text組件上綁定可以重復(fù)觸發(fā)的長按手勢為例：

// xxx.ets
@Entry
@Component
struct Index {
  @State count: number = 0;

  build() {
    Column() {
      Text('LongPress OnAction:' + this.count).fontSize(28)
        .gesture(
          // 綁定可以重復(fù)觸發(fā)的LongPressGesture
          LongPressGesture({ repeat: true })
            .onAction((event: GestureEvent) => {
              if (event.repeat) {
                this.count++;
              }
            })
            .onActionEnd(() => {
              this.count = 0;
            })
        )
    }
    .height(200)
    .width(250)
    .padding(20)
    .border({ width: 3 })
    .margin(30)
  }
}

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

拖動手勢用于觸發(fā)拖動手勢事件，滑動達到最小滑動距離（默認值為5vp）時拖動手勢識別成功，擁有三個可選參數(shù)：

• fingers：非必選參數(shù)，用于聲明觸發(fā)拖動手勢所需要的最少手指數(shù)量，最小值為1，最大值為10，默認值為1。
• direction：非必選參數(shù)，用于聲明觸發(fā)拖動的手勢方向，此枚舉值支持邏輯與（&）和邏輯或（|）運算。默認值為Pandirection.All。
• distance：非必選參數(shù)，用于聲明觸發(fā)拖動的最小拖動識別距離，單位為vp，默認值為5。

以在Text組件上綁定拖動手勢為例，可以通過在拖動手勢的回調(diào)函數(shù)中修改組件的布局位置信息來實現(xiàn)組件的拖動：

// xxx.ets
@Entry
@Component
struct Index {
  @State offsetX: number = 0;
  @State offsetY: number = 0;
  @State positionX: number = 0;
  @State positionY: number = 0;

  build() {
    Column() {
      Text('PanGesture Offset:\nX: ' + this.offsetX + '\n' + 'Y: ' + this.offsetY)
        .fontSize(28)
        .height(200)
        .width(300)
        .padding(20)
        .border({ width: 3 })
          // 在組件上綁定布局位置信息
        .translate({ x: this.offsetX, y: this.offsetY, z: 0 })
        .gesture(
          // 綁定拖動手勢
          PanGesture()
            .onActionStart((event: GestureEvent) => {
              console.info('Pan start');
            })
              // 當(dāng)觸發(fā)拖動手勢時，根據(jù)回調(diào)函數(shù)修改組件的布局位置信息
            .onActionUpdate((event: GestureEvent) => {
              this.offsetX = this.positionX + event.offsetX;
              this.offsetY = this.positionY + event.offsetY;
            })
            .onActionEnd(() => {
              this.positionX = this.offsetX;
              this.positionY = this.offsetY;
            })
        )
    }
    .height(200)
    .width(250)
  }
}

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

捏合手勢用于觸發(fā)捏合手勢事件，觸發(fā)捏合手勢的最少手指數(shù)量為2指，最大為5指，最小識別距離為5vp，擁有兩個可選參數(shù)：

• fingers：非必選參數(shù)，用于聲明觸發(fā)捏合手勢所需要的最少手指數(shù)量，最小值為2，最大值為5，默認值為2。
• distance：非必選參數(shù)，用于聲明觸發(fā)捏合手勢的最小距離，單位為vp，默認值為5。

以在Column組件上綁定三指捏合手勢為例，可以通過在捏合手勢的函數(shù)回調(diào)中獲取縮放比例，實現(xiàn)對組件的縮小或放大：

// xxx.ets
@Entry
@Component
struct Index {
  @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)
      .border({ width: 3 })
      .margin({ top: 100 })
      // 在組件上綁定縮放比例，可以通過修改縮放比例來實現(xiàn)組件的縮小或者放大
      .scale({ x: this.scaleValue, y: this.scaleValue, z: 1 })
      .gesture(
        // 在組件上綁定三指觸發(fā)的捏合手勢
        PinchGesture({ fingers: 3 })
          .onActionStart((event: GestureEvent) => {
            console.info('Pinch start');
          })
            // 當(dāng)捏合手勢觸發(fā)時，可以通過回調(diào)函數(shù)獲取縮放比例，從而修改組件的縮放比例
          .onActionUpdate((event: GestureEvent) => {
            this.scaleValue = this.pinchValue * event.scale;
            this.pinchX = event.pinchCenterX;
            this.pinchY = event.pinchCenterY;
          })
          .onActionEnd(() => {
            this.pinchValue = this.scaleValue;
            console.info('Pinch end');
          })
      )
    }
  }
}

RotationGesture(value?:{fingers?:number; angle?:number})

旋轉(zhuǎn)手勢用于觸發(fā)旋轉(zhuǎn)手勢事件，觸發(fā)旋轉(zhuǎn)手勢的最少手指數(shù)量為2指，最大為5指，最小改變度數(shù)為1度，擁有兩個可選參數(shù)：

• fingers：非必選參數(shù)，用于聲明觸發(fā)旋轉(zhuǎn)手勢所需要的最少手指數(shù)量，最小值為2，最大值為5，默認值為2。
• angle：非必選參數(shù)，用于聲明觸發(fā)旋轉(zhuǎn)手勢的最小改變度數(shù)，單位為deg，默認值為1。

以在Text組件上綁定旋轉(zhuǎn)手勢實現(xiàn)組件的旋轉(zhuǎn)為例，可以通過在旋轉(zhuǎn)手勢的回調(diào)函數(shù)中獲取旋轉(zhuǎn)角度，從而實現(xiàn)組件的旋轉(zhuǎn)：

// xxx.ets
@Entry
@Component
struct Index {
  @State angle: number = 0;
  @State rotateValue: number = 0;

  build() {
    Column() {
      Text('RotationGesture angle:' + this.angle).fontSize(28)
        // 在組件上綁定旋轉(zhuǎn)布局，可以通過修改旋轉(zhuǎn)角度來實現(xiàn)組件的旋轉(zhuǎn)
        .rotate({ angle: this.angle })
        .gesture(
          RotationGesture()
            .onActionStart((event: GestureEvent) => {
              console.info('RotationGesture is onActionStart');
            })
              // 當(dāng)旋轉(zhuǎn)手勢生效時，通過旋轉(zhuǎn)手勢的回調(diào)函數(shù)獲取旋轉(zhuǎn)角度，從而修改組件的旋轉(zhuǎn)角度
            .onActionUpdate((event: GestureEvent) => {
              this.angle = this.rotateValue + event.angle;
              console.info('RotationGesture is onActionEnd');
            })
              // 當(dāng)旋轉(zhuǎn)結(jié)束抬手時，固定組件在旋轉(zhuǎn)結(jié)束時的角度
            .onActionEnd(() => {
              this.rotateValue = this.angle;
              console.info('RotationGesture is onActionEnd');
            })
            .onActionCancel(() => {
              console.info('RotationGesture is onActionCancel');
            })
        )
    }
    .height(200)
    .width(250)
  }
}

SwipeGesture(value?:{fingers?:number; direction?:SwipeDirection; speed?:number})

滑動手勢用于觸發(fā)滑動事件，當(dāng)滑動速度大于100vp/s時可以識別成功，擁有三個可選參數(shù)：

• fingers：非必選參數(shù)，用于聲明觸發(fā)滑動手勢所需要的最少手指數(shù)量，最小值為1，最大值為10，默認值為1。
• direction：非必選參數(shù)，用于聲明觸發(fā)滑動手勢的方向，此枚舉值支持邏輯與（&）和邏輯或（|）運算。默認值為SwipeDirection.All。
• speed：非必選參數(shù)，用于聲明觸發(fā)滑動的最小滑動識別速度，單位為vp/s，默認值為100。

以在Column組件上綁定滑動手勢實現(xiàn)組件的旋轉(zhuǎn)為例：

// xxx.ets
@Entry
@Component
struct Index {
  @State rotateAngle: number = 0;
  @State speed: number = 1;

  build() {
    Column() {
      Column() {
        Text("SwipeGesture speed\n" + this.speed)
        Text("SwipeGesture angle\n" + this.rotateAngle)
      }
      .border({ width: 3 })
      .width(300)
      .height(200)
      .margin(100)
      // 在Column組件上綁定旋轉(zhuǎn)，通過滑動手勢的滑動速度和角度修改旋轉(zhuǎn)的角度
      .rotate({ angle: this.rotateAngle })
      .gesture(
        // 綁定滑動手勢且限制僅在豎直方向滑動時觸發(fā)
        SwipeGesture({ direction: SwipeDirection.Vertical })
          // 當(dāng)滑動手勢觸發(fā)時，獲取滑動的速度和角度，實現(xiàn)對組件的布局參數(shù)的修改
          .onAction((event: GestureEvent) => {
            this.speed = event.speed;
            this.rotateAngle = event.angle;
          })
      )
    }
  }
}