綁定手勢方法

為組件綁定不同類型的手勢事件，并設置事件的響應方法。

說明：
開發前請熟悉鴻蒙開發指導文檔 ：[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md]點擊或者復制轉到。
從API Version 7開始支持。后續版本如有新增內容，則采用上角標單獨標記該內容的起始版本。

綁定手勢識別

通過如下屬性給組件綁定手勢識別，手勢識別成功后可以通過事件回調通知組件。

GestureType

GestureMask枚舉說明

響應手勢事件

組件通過手勢事件綁定不同GestureType的手勢對象，各手勢對象在響應手勢操作的事件回調中提供手勢相關信息。下面通過TapGesture手勢對象的onAction事件響應點擊事件，獲取事件相關信息。其余手勢對象的事件定義見各個手勢對象章節。 若需綁定多種手勢請使用 [組合手勢]。

TapGesture事件說明

GestureEvent對象說明

SourceType枚舉說明

FingerInfo對象說明

SourceTool枚舉說明

示例

// xxx.ets
@Entry
@Component
struct GestureSettingsExample {
  @State priorityTestValue: string = ''
  @State parallelTestValue: string = ''

  build() {
    Column() {
      Column() {
        Text('TapGesture:' + this.priorityTestValue).fontSize(28)
          .gesture(
          TapGesture()
            .onAction(() = > {
              this.priorityTestValue += 'nText'
            }))
      }
      .height(200)
      .width(250)
      .padding(20)
      .margin(20)
      .border({ width: 3 })
      // 設置為priorityGesture時，點擊文本會忽略Text組件的TapGesture手勢事件，優先識別父組件Column的TapGesture手勢事件
      .priorityGesture(
      TapGesture()
        .onAction((event: GestureEvent) = > {
          this.priorityTestValue += 'nColumn'
        }), GestureMask.IgnoreInternal)

      Column() {
        Text('TapGesture:' + this.parallelTestValue).fontSize(28)
          .gesture(
          TapGesture()
            .onAction(() = > {
              this.parallelTestValue += 'nText'
            }))
      }
      .height(200)
      .width(250)
      .padding(20)
      .margin(20)
      .border({ width: 3 })
      // 設置為parallelGesture時，點擊文本會同時觸發子組件Text與父組件Column的TapGesture手勢事件
      .parallelGesture(
      TapGesture()
        .onAction((event: GestureEvent) = > {
          this.parallelTestValue += 'nColumn'
        }), GestureMask.Normal)
    }
  }
}