按键事件
按键事件指组件与键盘、遥控器等按键设备交互时触发的事件，适用于所有可获焦组件，例如Button。对于Text，Image等默认不可获焦的组件，可以设置focusable属性为true后使用按键事件。
说明
从API Version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
事件
名称 | 支持冒泡 | 功能描述 |
|---|---|---|
onKeyEvent(event: (event?: KeyEvent) => void) | 是 | 绑定该方法的组件获焦后，按键动作触发该回调，event返回值见KeyEvent介绍。 |
示例
- // xxx.ets
- @Entry
- @Component
- struct KeyEventExample {
- @State text: string = ''
- @State eventType: string = ''
- build() {
- Column() {
- Button('KeyEvent')
- .onKeyEvent((event: KeyEvent) => {
- if (event.type === KeyType.Down) {
- this.eventType = 'Down'
- }
- if (event.type === KeyType.Up) {
- this.eventType = 'Up'
- }
- this.text = 'KeyType:' + this.eventType + '\nkeyCode:' + event.keyCode + '\nkeyText:' + event.keyText
- })
- Text(this.text).padding(15)
- }.height(300).width('100%').padding(35)
- }
- }
