綁定手勢方法

為組件綁定不同類型的手勢事件，并設(shè)置事件的響應(yīng)方法。

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

綁定手勢識別

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

GestureType

GestureMask枚舉說明

響應(yīng)手勢事件

組件通過手勢事件綁定不同GestureType的手勢對象，各手勢對象在響應(yīng)手勢操作的事件回調(diào)中提供手勢相關(guān)信息。下面通過TapGesture手勢對象的onAction事件響應(yīng)點(diǎn)擊事件，獲取事件相關(guān)信息。其余手勢對象的事件定義見各個(gè)手勢對象章節(jié)。 若需綁定多種手勢請使用 [組合手勢]。

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 })
      // 設(shè)置為priorityGesture時(shí)，點(diǎn)擊文本會忽略Text組件的TapGesture手勢事件，優(yōu)先識別父組件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 })
      // 設(shè)置為parallelGesture時(shí)，點(diǎn)擊文本會同時(shí)觸發(fā)子組件Text與父組件Column的TapGesture手勢事件
      .parallelGesture(
      TapGesture()
        .onAction((event: GestureEvent) = > {
          this.parallelTestValue += 'nColumn'
        }), GestureMask.Normal)
    }
  }
}