單擊、雙擊和多次點(diǎn)擊事件的識別

2024-01-22 16:47 更新

支持單擊、雙擊和多次點(diǎn)擊事件的識別。

說明

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

接口

TapGesture(value?: { count?: number, fingers?: number })

參數(shù):

參數(shù)名稱

參數(shù)類型

必填

參數(shù)描述

count

number

識別的連續(xù)點(diǎn)擊次數(shù)。當(dāng)設(shè)置的值小于1或不設(shè)置時,會被轉(zhuǎn)化為默認(rèn)值。

默認(rèn)值:1

說明:

如配置多擊,上一次抬起和下一次按下的超時時間為300毫秒。

fingers

number

觸發(fā)點(diǎn)擊的手指數(shù),最小為1指, 最大為10指。當(dāng)設(shè)置小于1的值或不設(shè)置時,會被轉(zhuǎn)化為默認(rèn)值。

默認(rèn)值:1

說明:

1. 當(dāng)配置多指時,第一根手指按下后300毫秒內(nèi)未有足夠的手指數(shù)按下,手勢識別失敗。

2. 實(shí)際點(diǎn)擊手指數(shù)超過配置值,手勢識別失敗。

事件

名稱

功能描述

onAction(event: (event?: GestureEvent) => void)

Tap手勢識別成功回調(diào)。

示例

  1. // xxx.ets
  2. @Entry
  3. @Component
  4. struct TapGestureExample {
  5. @State value: string = ''
  6. build() {
  7. Column() {
  8. // 單指雙擊文本觸發(fā)手勢事件
  9. Text('Click twice').fontSize(28)
  10. .gesture(
  11. TapGesture({ count: 2 })
  12. .onAction((event: GestureEvent) => {
  13. this.value = JSON.stringify(event.fingerList[0])
  14. })
  15. )
  16. Text(this.value)
  17. }
  18. .height(200)
  19. .width(300)
  20. .padding(20)
  21. .border({ width: 3 })
  22. .margin(30)
  23. }
  24. }

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

掃描二維碼

下載編程獅App

公眾號
微信公眾號

編程獅公眾號