綁定手勢(shì)方法

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

說明：
開發(fā)前請(qǐng)熟悉鴻蒙開發(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)容的起始版本。

綁定手勢(shì)識(shí)別

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

GestureType

GestureMask枚舉說明

響應(yīng)手勢(shì)事件

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

TapGesture事件說明

GestureEvent對(duì)象說明

SourceType枚舉說明

FingerInfo對(duì)象說明

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