按键事件
按键事件指组件与键盘、遥控器等按键设备交互时触发的事件。
说明:
从API Version 7开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
权限列表
无
事件
名称 | 支持冒泡 | 功能描述 |
---|---|---|
onKeyEvent(event: (event?: KeyEvent) => void) | 是 | 绑定该方法的组件获焦后,按键动作触发该方法调用,event参数见KeyEvent介绍。 |
KeyEvent对象说明
属性
属性名称 | 类型 | 描述 |
---|---|---|
type | KeyType | 按键的类型。 |
keyCode | number | 按键的键码。 |
keyText | string | 按键的键值。 |
keySource | KeySource | 触发当前按键的输入设备类型。 |
deviceId | number | 触发当前按键的输入设备ID。 |
metaKey | number | 按键发生时元键的状态,1表示按压态,0表示未按压态。 |
timestamp | number | 按键发生时的时间戳。 |
接口
接口名称 | 功能描述 |
---|---|
stopPropagation(): void | 阻塞事件冒泡传递。 |
示例
// xxx.ets
@Entry
@Component
struct KeyEventExample {
@State text: string = ''
@State eventType: string = ''
build() {
Column() {
Button('KeyEvent').backgroundColor(0x2788D9)
.onKeyEvent((event: KeyEvent) => {
if (event.type === KeyType.Down) {
this.eventType = 'Down'
}
if (event.type === KeyType.Up) {
this.eventType = 'Up'
}
console.info(this.text = 'KeyType:' + this.eventType + '\nkeyCode:' + event.keyCode + '\nkeyText:' + event.keyText)
})
Text(this.text).padding(15)
}.height(300).width('100%').padding(35)
}
}