• HarmonyOS应用API手势方法-绑定手势方法


    述:为组件绑定不同类型的手势事件,并设置事件的响应方法。

    Api:从API Version 7开始支持

    一、绑定手势识别:

    通过如下属性给组件绑定手势识别,手势识别成功后可以通过事件回调通知组件。

    名称参数类型默认值描述
    gesturegesture:GestureType,mask?: GestureMaskgesture: -,mask: GestureMask.Normal绑定手势。- gesture: 绑定的手势类型,- mask: 事件响应设置。
    priorityGesturegesture:GestureType,mask?: GestureMaskgesture: -,mask: GestureMask.Normal绑定优先识别手势。- gesture: 绑定的手势类型,- mask: 事件响应设置。默认情况下,子组件优先识别通过gesture绑定的手势,当父组件配置priorityGesture时,子组件优先识别priorityGesture绑定的手势。
    parallelGesturegesture:GestureType,mask?: GestureMaskgesture: -,mask: GestureMask.Normal绑定可与子组件手势同时触发的手势。- gesture: 绑定的手势类型。- mask: 事件响应设置。手势事件为非冒泡事件。父组件设置parallelGesture时,父子组件相同的手势事件都可以触发,实现类似冒泡效果。

    响应手势事件:

    组件通过手势事件绑定不同GestureType的手势对象,各手势对象提供的事件响应手势操作,提供手势相关信息。下面通过TapGesture对象的onAction事件响应点击事件,获取事件相关信息。其余手势对象的事件定义见各个手势对象章节。 若需绑定多种手势请使用 组合手势

    TapGesture事件说明:

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

    多类枚举对象参考:

    文档中心

    二、示例代码:

    1. @Entry
    2. @Component
    3. struct GestureSettingsExample {
    4. @State priorityTestValue: string = '';
    5. @State parallelTestValue: string = '';
    6. @State num:number = 0;
    7. build() {
    8. Column() {
    9. Column() {
    10. Text('TapGesture:' + this.priorityTestValue).fontSize(28)
    11. .gesture(
    12. TapGesture()
    13. .onAction(() => {
    14. this.priorityTestValue += '\nText';
    15. }))
    16. }
    17. .height(300)
    18. .width(300)
    19. .padding(20)
    20. .margin(20)
    21. .border({ width: 3 })
    22. // 设置为priorityGesture时,点击文本会忽略Text组件的TapGesture手势事件,优先识别父组件Column的TapGesture手势事件
    23. .priorityGesture(
    24. TapGesture()
    25. .onAction((event: GestureEvent) => {
    26. this.num ++
    27. this.priorityTestValue += '\nColumn' + this.num;
    28. }), GestureMask.IgnoreInternal)
    29. Column() {
    30. Text('TapGesture:' + this.parallelTestValue).fontSize(28)
    31. .gesture(
    32. TapGesture()
    33. .onAction(() => {
    34. this.num ++
    35. this.parallelTestValue += '\nText' + this.num;
    36. }))
    37. }
    38. .height(300)
    39. .width(300)
    40. .padding(20)
    41. .margin(20)
    42. .border({ width: 3 })
    43. // 设置为parallelGesture时,点击文本会同时触发子组件Text与父组件Column的TapGesture手势事件
    44. .parallelGesture(
    45. TapGesture()
    46. .onAction((event: GestureEvent) => {
    47. this.parallelTestValue += '\nColumn';
    48. }), GestureMask.Normal)
    49. }
    50. }
    51. }
    52. 复制

    三、实例效果

    4.代码地址

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

     

  • 相关阅读:
    Java中的String类
    java基于springboot+vue的汉服推广与交流平台
    uniapp的动态表单实现
    input时间控件选择时禁用某个日期之前或之后
    Redis之zset类型
    Python数据分析与建模库-03数据分析处理库Pandas-1.数据读取
    依赖注入的工作流程
    你适合考PMP还是软考?两者的区别是否清楚,分别能给你带来什么价值
    springBoot依赖管理机制
    【PTA-训练day7】L2-019 悄悄关注 + L1-027 出租
  • 原文地址:https://blog.csdn.net/weixin_69135651/article/details/128002119