鸿蒙HarmonyOS (ArkTS组件)触摸事件

当手指在组件上按下、滑动、抬起时触发。

onTouch

onTouch(event: (event: TouchEvent) => void): T

手指触摸动作触发该回调。

元服务API: 从API version 11开始,该接口支持在元服务中使用。

系统能力: SystemCapability.ArkUI.ArkUI.Full

参数:

参数名类型必填说明
eventTouchEvent获得TouchEvent对象。

返回值:

类型说明
T返回当前组件。

TouchEvent对象说明

继承于BaseEvent。非事件注入场景下,changedTouches是按屏幕显示刷新率重采样的点,touches是按器件刷新率报上来的点,changedTouches的数据可能会和touches里面的不相同。

系统能力: SystemCapability.ArkUI.ArkUI.Full

名称类型描述
typeTouchType

触摸事件的类型。

元服务API: 从API version 11开始,该接口支持在元服务中使用。

touchesArray<TouchObject>

全部手指信息。

元服务API: 从API version 11开始,该接口支持在元服务中使用。

changedTouchesArray<TouchObject>

当前发生变化的手指信息。

元服务API: 从API version 11开始,该接口支持在元服务中使用。

stopPropagation() => void

阻塞事件冒泡。

元服务API: 从API version 11开始,该接口支持在元服务中使用。

preventDefault12+() => void

阻止默认事件,具体功能暂未实现。

元服务API: 从API version 12开始,该接口支持在元服务中使用。

getHistoricalPoints10+

getHistoricalPoints(): Array<HistoricalPoint>

获取当前帧所有的历史点。不同设备每帧的触摸事件频率不同,且该接口只能在TouchEvent中调用,可以通过该接口获取触发onTouch时当前帧历史点的相关信息。onTouch一帧只会调用一次,若当前帧收到的TouchEvent大于1,会将该帧最后一个点通过onTouch返还,剩余点作为历史点。

元服务API: 从API version 11开始,该接口支持在元服务中使用。

系统能力: SystemCapability.ArkUI.ArkUI.Full

返回值:

类型描述
Array<HistoricalPoint>由历史点组成的数组。

TouchObject对象说明

系统能力: SystemCapability.ArkUI.ArkUI.Full

名称类型描述
typeTouchType

触摸事件的类型。

元服务API: 从API version 11开始,该接口支持在元服务中使用。

idnumber

手指唯一标识符。

元服务API: 从API version 11开始,该接口支持在元服务中使用。

xnumber

触摸点相对于事件响应组件的左上角的X坐标。

单位:vp

元服务API: 从API version 11开始,该接口支持在元服务中使用。

ynumber

触摸点相对于事件响应组件的左上角的Y坐标。

单位:vp

元服务API: 从API version 11开始,该接口支持在元服务中使用。

windowX10+number

触摸点相对于应用窗口左上角的X坐标。

单位:vp

元服务API: 从API version 11开始,该接口支持在元服务中使用。

windowY10+number

触摸点相对于应用窗口左上角的Y坐标。

单位:vp

元服务API: 从API version 11开始,该接口支持在元服务中使用。

displayX10+number

触摸点相对于应用屏幕左上角的X坐标。

单位:vp

元服务API: 从API version 11开始,该接口支持在元服务中使用。

displayY10+number

触摸点相对于应用屏幕左上角的Y坐标。

单位:vp

元服务API: 从API version 11开始,该接口支持在元服务中使用。

screenX(deprecated)number

触摸点相对于应用窗口左上角的X坐标。

单位:vp

从API version 10开始不再维护,建议使用windowX代替。

screenY(deprecated)number

触摸点相对于应用窗口左上角的Y坐标。

单位:vp

从API version 10开始不再维护,建议使用windowY代替。

HistoricalPoint10+对象说明

元服务API: 从API version 11开始,该接口支持在元服务中使用。

系统能力: SystemCapability.ArkUI.ArkUI.Full

名称类型描述
touchObjectTouchObject历史点对应触摸事件的基础信息。
sizenumber

历史点对应触摸事件的手指与屏幕的触摸区域大小。

默认值:0

forcenumber

历史点对应触摸事件的压力大小。

默认值:0

取值范围:[0,65535),压力越大值越大。

timestampnumber

历史点对应触摸事件的时间戳。触发事件时距离系统启动的时间间隔。

单位:ns

示例

该示例通过按钮设置了触摸事件,手指点击按钮时可获取触摸事件的相关参数。

  1. // xxx.ets
    @Entry
    @Component
    struct TouchExample {
      @State text: string = ''
      @State eventType: string = ''
    
      build() {
        Column() {
          Button('Touch').height(40).width(100)
            .onTouch((event?: TouchEvent) => {
              if(event){
                if (event.type === TouchType.Down) {
                  this.eventType = 'Down'
                }
                if (event.type === TouchType.Up) {
                  this.eventType = 'Up'
                }
                if (event.type === TouchType.Move) {
                  this.eventType = 'Move'
                }
                this.text = 'TouchType:' + this.eventType + '\nDistance between touch point and touch element:\nx: '
                + event.touches[0].x + '\n' + 'y: ' + event.touches[0].y + '\nComponent globalPos:('
                + event.target.area.globalPosition.x + ',' + event.target.area.globalPosition.y + ')\nwidth:'
                + event.target.area.width + '\nheight:' + event.target.area.height
              }
            })
          Button('Touch').height(50).width(200).margin(20)
            .onTouch((event?: TouchEvent) => {
              if(event){
                if (event.type === TouchType.Down) {
                  this.eventType = 'Down'
                }
                if (event.type === TouchType.Up) {
                  this.eventType = 'Up'
                }
                if (event.type === TouchType.Move) {
                  this.eventType = 'Move'
                }
                this.text = 'TouchType:' + this.eventType + '\nDistance between touch point and touch element:\nx: '
                + event.touches[0].x + '\n' + 'y: ' + event.touches[0].y + '\nComponent globalPos:('
                + event.target.area.globalPosition.x + ',' + event.target.area.globalPosition.y + ')\nwidth:'
                + event.target.area.width + '\nheight:' + event.target.area.height
              }
            })
          Text(this.text)
        }.width('100%').padding(30)
      }
    }

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值