当手指在组件上按下、滑动、抬起时触发。
说明
从API Version 7开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
onTouch
onTouch(event: (event: TouchEvent) => void): T
手指触摸动作触发该回调。
元服务API: 从API version 11开始,该接口支持在元服务中使用。
系统能力: SystemCapability.ArkUI.ArkUI.Full
参数:
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
event | [TouchEvent] | 是 | 获得TouchEvent对象。 |
返回值:
类型 | 说明 |
---|---|
T | 返回当前组件。 |
TouchEvent对象说明
继承于[BaseEvent]。非事件注入场景下,changedTouches是按屏幕显示刷新率重采样的点,touches是按器件刷新率报上来的点,changedTouches的数据可能会和touches里面的不相同。
系统能力: SystemCapability.ArkUI.ArkUI.Full
名称 | 类型 | 描述 |
---|---|---|
type | [TouchType] | 触摸事件的类型。元服务API: 从API version 11开始,该接口支持在元服务中使用。 |
touches | Array<[TouchObject]> | 全部手指信息。元服务API: 从API version 11开始,该接口支持在元服务中使用。 |
changedTouches |