绑定手势方法

可以通过如下属性给组件绑定手势识别，手势识别成功后可以通过事件回调通知组件。

• GestureMask枚举说明

  名称	描述
  Normal	不屏蔽子组件的手势，按照默认手势识别顺序进行识别。
  IgnoreInternal	屏蔽子组件的手势，仅当前容器的手势进行识别。 说明： 子组件上系统内置的手势不会被屏蔽，如子组件为List组件时，内置的滑动手势仍然会触发。

• 系统提供如下Gesture类型

  名称	描述
  TapGesture	点击手势，支持单次点击、多次点击识别。
  LongPressGesture	长按手势。
  PanGesture	平移手势。
  PinchGesture	捏合手势。
  RotationGesture	旋转手势。
  GestureGroup	手势识别组，多种手势组合为复合手势，支持连续识别、并行识别和互斥识别。

响应手势事件

组件通过gesture方法绑定手势对象，可以通过手势对象提供的事件相应响应手势操作。如通过TapGesture对象的onAction事件响应点击事件。具体事件定义见各个手势对象章节。

• TapGesture事件说明

  名称		功能描述
  onAction((event?: GestureEvent) => void)		Tap手势识别成功回调。

• GestureEvent对象说明

  属性名称	属性类型	描述
  repeat	boolean	事件是否为重复触发事件，用于LongPressGesture场景。
  offsetX	number	手势事件偏移量，用于PanGesture手势触发场景，单位为vp。
  offsetY	number	手势事件偏移量，用于PanGesture手势触发场景，单位为vp。
  scale	number	缩放比例，用于PinchGesture手势触发场景。
  pinchCenterX	number	捏合手势中心点X轴坐标，用于PinchGesture手势触发场景，单位为px。
  pinchCenterY	number	捏合手势中心点Y轴坐标，用于PinchGesture手势触发场景，单位为px。
  angle	number	旋转角度，用于RotationGesture手势触发场景。
  timestamp	number	事件时间戳。

示例

@Entry
@Component
struct GestureSettingsExample {
  @State value: string = ''

  build() {
    Column() {
      Text('Click\n' + this.value).gesture(TapGesture()
        .onAction(() => {
          this.value = 'gesture onAction'
        }))
    }.height(200).width(300).padding(60).border({ width: 1 }).margin(30)
    //设置为priorityGesture时，会优先识别该绑定手势忽略内部gesture手势
    .priorityGesture(
      TapGesture()
        .onAction(() => {
          this.value = 'priorityGesture onAction'
        }), GestureMask.IgnoreInternal
    )
  }
}