触摸事件
当手指在组件上按下、滑动、抬起时触发。
说明:
从API Version 7开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
onTouch
onTouch(event: (event: TouchEvent) => void): T
手指触摸动作触发该回调。
原子化服务API: 从API version 11开始,该接口支持在原子化服务中使用。
系统能力: SystemCapability.ArkUI.ArkUI.Full
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
event | TouchEvent | 是 | 获得TouchEvent对象。 |
返回值:
类型 | 说明 |
---|---|
T | 返回当前组件。 |
TouchEvent对象说明
继承于BaseEvent。
系统能力: SystemCapability.ArkUI.ArkUI.Full
名称 | 类型 | 描述 |
---|---|---|
type | TouchType | 触摸事件的类型。 原子化服务API: 从API version 11开始,该接口支持在原子化服务中使用。 |
touches | Array<TouchObject> | 全部手指信息。 原子化服务API: 从API version 11开始,该接口支持在原子化服务中使用。 |
changedTouches | Array<TouchObject> | 当前发生变化的手指信息。 原子化服务API: 从API version 11开始,该接口支持在原子化服务中使用。 |
stopPropagation | () => void | 阻塞事件冒泡。 原子化服务API: 从API version 11开始,该接口支持在原子化服务中使用。 |
timestamp8+ | number | 事件时间戳,触发事件时距离系统启动的时间间隔。 例如,当系统启动时间为2023/10/12 11:33, 在2023/10/12 11:34时触发触摸事件,时间戳返回的值为60,000,000,000ns。 单位:ns 卡片能力: 从API version 9开始,该接口支持在ArkTS卡片中使用。 原子化服务API: 从API version 11开始,该接口支持在原子化服务中使用。 |
target8+ |