單擊、雙擊和多次點擊事件的識別

2024-01-22 16:47 更新

支持單擊、雙擊和多次點擊事件的識別。

說明

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

接口

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

參數(shù):

參數(shù)名稱

參數(shù)類型

必填

參數(shù)描述

count

number

識別的連續(xù)點擊次數(shù)。當設置的值小于1或不設置時,會被轉化為默認值。

默認值:1

說明:

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

fingers

number

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

默認值:1

說明:

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

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

事件

名稱

功能描述

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

Tap手勢識別成功回調。

示例

  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. }

以上內容是否對您有幫助:
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號
微信公眾號

編程獅公眾號