觸發(fā)長按手勢事件

2024-01-22 16:47 更新

用于觸發(fā)長按手勢事件,觸發(fā)長按手勢的最少手指數(shù)為1,最短長按時間為500毫秒。

說明

從API Version 7開始支持。后續(xù)版本如有新增內(nèi)容,則采用上角標(biāo)單獨(dú)標(biāo)記該內(nèi)容的起始版本。

接口

LongPressGesture(value?: { fingers?: number, repeat?: boolean, duration?: number })

參數(shù):

參數(shù)名稱參數(shù)類型必填參數(shù)描述
fingersnumber

觸發(fā)長按的最少手指數(shù),最小為1指, 最大取值為10指。

默認(rèn)值:1

repeatboolean

是否連續(xù)觸發(fā)事件回調(diào)。

默認(rèn)值:false

durationnumber

觸發(fā)長按的最短時間,單位為毫秒(ms)。

默認(rèn)值:500

事件

名稱功能描述
onAction(event:(event?: GestureEvent) => void)LongPress手勢識別成功回調(diào)。
onActionEnd(event:(event?: GestureEvent) => void)LongPress手勢識別成功,手指抬起后觸發(fā)回調(diào)。
onActionCancel(event: () => void)LongPress手勢識別成功,接收到觸摸取消事件觸發(fā)回調(diào)。

示例

  1. // xxx.ets
  2. @Entry
  3. @Component
  4. struct LongPressGestureExample {
  5. @State count: number = 0
  6. build() {
  7. Column() {
  8. Text('LongPress onAction:' + this.count).fontSize(28)
  9. // 單指長按文本觸發(fā)該手勢事件
  10. .gesture(
  11. LongPressGesture({ repeat: true })
  12. // 由于repeat設(shè)置為true,長按動作存在時會連續(xù)觸發(fā),觸發(fā)間隔為duration(默認(rèn)值500ms)
  13. .onAction((event: GestureEvent) => {
  14. if (event.repeat) {
  15. this.count++
  16. }
  17. })
  18. // 長按動作一結(jié)束觸發(fā)
  19. .onActionEnd(() => {
  20. this.count = 0
  21. })
  22. )
  23. }
  24. .height(200)
  25. .width(300)
  26. .padding(20)
  27. .border({ width: 3 })
  28. .margin(30)
  29. }
  30. }

以上內(nèi)容是否對您有幫助:
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號
微信公眾號

編程獅公眾號