綁定手勢(shì)方法

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

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

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

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

GestureType

GestureMask枚舉說(shuō)明

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

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

TapGesture事件說(shuō)明

GestureEvent對(duì)象說(shuō)明

SourceType枚舉說(shuō)明

FingerInfo對(duì)象說(shuō)明

SourceTool枚舉說(shuō)明

示例

// 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)
    }
  }
}