> 文档中心 > HarmonyOS应用API手势方法-TapGesture

HarmonyOS应用API手势方法-TapGesture

描述:支持单次点击、多次点击识别。

Api:从API Version 7开始支持

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

参数

参数名称 参数类型 必填 参数描述
count number 识别的连续点击次数。如果设置小于1,会被转化为默认值。默认值:1>说明:> 如配置多击,上一次抬起和下一次按下的超时时间为300毫秒(ms)。
fingers number 触发点击的最少手指数,最小为1指, 最大为10指。默认值:1>说明:> 1. 当配置多指时,第一根手指按下后300毫秒(ms)内未有足够的手指数按下,手势识别失败。> 2. 实际点击手指数超过配置值,手势识别失败。

事件

名称 功能描述
onAction(event: (event?:GestureEvent) => void) Tap手势识别成功回调。

示例代码:

@Entry@Componentstruct Index {  @State value: string = '';  build() {    Column() {      // 单指双击文本触发手势事件      Text('Click twice').fontSize(28).margin({ top: 40 }) .gesture( TapGesture({ count: 2 })   .onAction((event: GestureEvent) => {     this.value = JSON.stringify(event.fingerList[0]);   }) )      Column(){ Text(this.value).fontSize(20)      }      .height(300)      .width(300)      .padding(20)      .border({ width: 3 })      .margin(30)    }  }}复制

示例效果:

代码地址:

HarmonyOSAPP开发相关组件: 深圳市蛟龙腾飞网络科技有限公司 - Gitee.com