鸿蒙HarmonyOS NEXT开发：TapGesture(基础手势)

最新推荐文章于 2024-09-07 12:24:42 发布

「已注销」

最新推荐文章于 2024-09-07 12:24:42 发布

阅读量418

点赞数 4

分类专栏：鸿蒙 ArkTS 文章标签： harmonyos 华为 android 驱动开发鸿蒙

本文链接：https://blog.csdn.net/shudaoshanbbq/article/details/141174880

版权

鸿蒙同时被 2 个专栏收录

99 篇文章 0 订阅

订阅专栏

ArkTS

94 篇文章 0 订阅

订阅专栏

TapGesture

支持单击、双击和多次点击事件的识别。

说明：

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

接口

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

原子化服务API： 从API version 11开始，该接口支持在原子化服务中使用。

参数：

参数名称	参数类型	必填	参数描述
count	number	否	识别的连续点击次数。当设置的值小于1或不设置时，会被转化为默认值。默认值：1 说明： 1. 当配置多击时，上一次的最后一根手指抬起和下一次的第一根手指按下的超时时间为300毫秒。 2. 当上次点击的位置与当前点击的位置距离超过60vp时，手势识别失败。
fingers	number	否	触发点击的手指数，最小为1指，最大为10指。当设置小于1的值或不设置时，会被转化为默认值。默认值：1 说明： 1. 当配置多指时，第一根手指按下后300毫秒内未有足够的手指数按下，手势识别失败；手指抬起时，抬起后剩余的手指数小于阈值时开始计时，如300ms内未全部抬起则手势识别失败。 2. 实际点击手指数超过配置值，手势识别成功。

事件

名称	功能描述
onAction(event: (event: GestureEvent) => void)	Tap手势识别成功回调。原子化服务API：从API version 11开始，该接口支持在原子化服务中使用。

属性

原子化服务API： 从API version 11开始，该接口支持在原子化服务中使用。

名称	类型	描述
tag11+	string	设置Tap手势标志，用于自定义手势判定时区分绑定的手势。

示例

// xxx.ets
@Entry
@Component
struct TapGestureExample {
  @State value: string = ''

  build() {
    Column() {
      // 单指双击文本触发手势事件
      Text('Click twice').fontSize(28)
        .gesture(
        TapGesture({ count: 2 })
          .onAction((event: GestureEvent) => {
            if (event) {
              this.value = JSON.stringify(event.fingerList[0])
            }
          })
        )
      Text(this.value)
    }
    .height(200)
    .width(300)
    .padding(20)
    .border({ width: 3 })
    .margin(30)
  }
}
ts