触发长按手势事件

2024-01-22 16:47 更新

用于触发长按手势事件,触发长按手势的最少手指数为1,最短长按时间为500毫秒。

说明

从API Version 7开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。

接口

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

参数:

参数名称参数类型必填参数描述
fingersnumber

触发长按的最少手指数,最小为1指, 最大取值为10指。

默认值:1

repeatboolean

是否连续触发事件回调。

默认值:false

durationnumber

触发长按的最短时间,单位为毫秒(ms)。

默认值:500

事件

名称功能描述
onAction(event:(event?: GestureEvent) => void)LongPress手势识别成功回调。
onActionEnd(event:(event?: GestureEvent) => void)LongPress手势识别成功,手指抬起后触发回调。
onActionCancel(event: () => void)LongPress手势识别成功,接收到触摸取消事件触发回调。

示例

  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. // 单指长按文本触发该手势事件
  10. .gesture(
  11. LongPressGesture({ repeat: true })
  12. // 由于repeat设置为true,长按动作存在时会连续触发,触发间隔为duration(默认值500ms)
  13. .onAction((event: GestureEvent) => {
  14. if (event.repeat) {
  15. this.count++
  16. }
  17. })
  18. // 长按动作一结束触发
  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. }

以上内容是否对您有帮助:
在线笔记
App下载
App下载

扫描二维码

下载编程狮App

公众号
微信公众号

编程狮公众号