小工具知识网

当前位置: 首页 > 行业知识 > 鸿蒙Harmony应用开发—ArkTS声明式开发(基础手势:LongPressGesture)

行业知识

鸿蒙Harmony应用开发—ArkTS声明式开发(基础手势:LongPressGesture)

2026-11-17 19:45:34 来源:互联网转载

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

说明:

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

接口

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

当组件默认支持可拖拽时,如Text、TextInput、TextArea、HyperLink、Image和RichEditor等组件。长按手势与拖拽会出现冲突,事件优先级如下:

长按触发时间

长按触发时间 >= 500ms,拖拽事件优先长按事件响应。

参数:

参数名称参数类型必填参数描述
fingersnumber否触发长按的最少手指数,最小为1指, 最大取值为10指。

默认值:1
说明:

手指按下后若发生超过15px的移动,则判定当前长按手势识别失败。

repeatboolean否是否连续触发事件回调。

默认值:false

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

默认值:500
说明:

设置小于等于0时,按照默认值500处理。

事件

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

在窗口失焦的时候会触发。

属性

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

示例

// xxx.ets@Entry@Componentstruct LongPressGestureExample {  @State count: number = 0  build() {    Column() {      Text('LongPress onAction:' + this.count).fontSize(28)        // 单指长按文本触发该手势事件        .gesture(        LongPressGesture({ repeat: true })          // 由于repeat设置为true,长按动作存在时会连续触发,触发间隔为duration(默认值500ms)          .onAction((event?: GestureEvent) => {            if (event && event.repeat) {              this.count++            }          })            // 长按动作一结束触发          .onActionEnd(() => {            this.count = 0          })        )    }    .height(200)    .width(300)    .padding(20)    .border({ width: 3 })    .margin(30)  }}

最后,有很多小伙伴不知道学习哪些鸿蒙开发技术?不知道需要重点掌握哪些鸿蒙应用开发知识点?而且学习时频繁踩坑,最终浪费大量时间。所以有一份实用的鸿蒙(Harmony NEXT)资料用来跟着学习是非常有必要的。 

这份鸿蒙(Harmony NEXT)资料包含了鸿蒙开发必掌握的核心知识要点,内容包含了(ArkTS、ArkUI开发组件、Stage模型、多端部署、分布式应用开发、音频、视频、WebGL、OpenHarmony多媒体技术、Napi组件、OpenHarmony内核、Harmony南向开发、鸿蒙项目实战等等)鸿蒙(Harmony NEXT)技术知识点。

希望这一份鸿蒙学习资料能够给大家带来帮助,有需要的小伙伴自行领取,限时开源,先到先得~无套路领取!!

 获取这份完整版高清学习路线,请点击→纯血版全套鸿蒙HarmonyOS学习资料

鸿蒙(Harmony NEXT)最新学习路线

  •  HarmonOS基础技能

    • HarmonOS就业必备技能 
    •  HarmonOS多媒体技术
      • 鸿蒙NaPi组件进阶
        • HarmonOS高级技能
          • 初识HarmonOS内核 
          • 实战就业级设备开发

            有了路线图,怎么能没有学习资料呢,小编也准备了一份联合鸿蒙官方发布笔记整理收纳的一套系统性的鸿蒙(OpenHarmony )学习手册(共计1236页)与鸿蒙(OpenHarmony )开发入门教学视频,内容包含:ArkTS、ArkUI、Web开发、应用模型、资源分类…等知识点。

            获取以上完整版高清学习路线,请点击→纯血版全套鸿蒙HarmonyOS学习资料

            《鸿蒙 (OpenHarmony)开发入门教学视频》

            《鸿蒙生态应用开发V2.0白皮书》

            《鸿蒙 (OpenHarmony)开发基础到实战手册》

            OpenHarmony北向、南向开发环境搭建

             《鸿蒙开发基础》

            • ArkTS语言
            • 安装DevEco Studio
            • 运用你的第一个ArkTS应用
            • ArkUI声明式UI开发
            • .……

               《鸿蒙开发进阶》

              • Stage模型入门
              • 网络管理
              • 数据管理
              • 电话服务
              • 分布式应用开发
              • 通知与窗口管理
              • 多媒体技术
              • 安全技能
              • 任务管理
              • WebGL
              • 国际化开发
              • 应用测试
              • DFX面向未来设计
              • 鸿蒙系统移植和裁剪定制
              • ……

                《鸿蒙进阶实战》

                • ArkTS实践
                • UIAbility应用
                • 网络案例
                • ……

                   获取以上完整鸿蒙HarmonyOS学习资料,请点击→纯血版全套鸿蒙HarmonyOS学习资料

                  总结

                  总的来说,华为鸿蒙不再兼容安卓,对中年程序员来说是一个挑战,也是一个机会。只有积极应对变化,不断学习和提升自己,他们才能在这个变革的时代中立于不败之地。 

上一篇:香肠派对维护服务器在哪里?

下一篇:疫情防控复工复产备案表怎么填写图片