鸿蒙OS开发文档 鸿蒙OS 组件通用事件

2024-02-25 开发教程 鸿蒙OS开发文档 匿名 2

相对于私有事件,大部分组件都可以绑定如下事件。

名称参数描述
touchstartTouchEvent手指刚触摸屏幕时触发该事件。
touchmoveTouchEvent手指触摸屏幕后移动时触发该事件。
touchcancelTouchEvent手指触摸屏幕中动作被打断时触发该事件。
touchendTouchEvent手指触摸结束离开屏幕时触发该事件。
click-点击动作触发该事件。
longpress-长按动作触发该事件。
focus-获得焦点时触发该事件,span组件无法获取焦点。
blur-失去焦点时触发该事件,span组件无法失去焦点。
keyKeyEvent智慧屏特有的按键事件,当用户操作遥控器按键时触发。返回true表示页面自己处理按键事件。返回false表示使用默认的按键事件逻辑。不返回值作为false处理。
属性类型说明
typestring当前事件的类型,比如click、longpress等。
timestampnumber该事件触发时的时间戳。
属性类型说明
touchesArray<Object>触摸事件时的属性集合,包含屏幕触摸点的信息数组。
changedTouchesArray<Object>触摸事件时的属性集合,包括产生变化的屏幕触摸点的信息数组。数据数据格式和touches一样。该属性表示有变化的触摸点,如从无变有,位置变化,从有变无。例如用户手指刚接触屏幕时,touches数组中有数据,但changedTouches无数据。
属性类型说明
globalXnumber距离屏幕左上角(不包括状态栏)横向距离。屏幕的左上角为原点。
globalYnumber距离屏幕左上角(不包括状态栏)纵向距离。屏幕的左上角为原点。
localXnumber距离被触摸组件左上角横向距离。组件的左上角为原点。
localYnumber距离被触摸组件左上角纵向距离。组件的左上角为原点。
sizenumber触摸接触面积。
属性类型说明
codenumber智慧屏遥控器的按键值。常用按键值详见表5
actionnumber按键事件的按键类型:0:down1:up2:multiple用户点击一个遥控器按键,通常会触发两次key事件,先触发down事件,再触发up事件。当用户按下按键不放手时,action为2,此时repeatCount将返回次数。
repeatCountnumber按键重复次数。
timestampStartnumber按键按下时的时间戳。
数值行为物理按键
19向上方向键
20向下方向键
21向左方向键
22向右方向键
23确定智慧屏遥控器的确认键
66确定键盘的回车键
160确定键盘的小键盘回车键