W3Cschool
恭喜您成為首批注冊(cè)用戶
獲得88經(jīng)驗(yàn)值獎(jiǎng)勵(lì)
按鍵事件指組件與鍵盤、遙控器等按鍵設(shè)備交互時(shí)觸發(fā)的事件,適用于所有可獲焦組件,例如Button。對(duì)于Text,Image等默認(rèn)不可獲焦的組件,可以設(shè)置focusable屬性為true后使用按鍵事件。
從API Version 7開始支持。后續(xù)版本如有新增內(nèi)容,則采用上角標(biāo)單獨(dú)標(biāo)記該內(nèi)容的起始版本。
名稱 | 支持冒泡 | 功能描述 |
---|---|---|
onKeyEvent(event: (event?: KeyEvent) => void) | 是 | 綁定該方法的組件獲焦后,按鍵動(dòng)作觸發(fā)該回調(diào),event返回值見KeyEvent介紹。 |
名稱 | 類型 | 描述 |
---|---|---|
type | 按鍵的類型。 | |
number | 按鍵的鍵碼。 | |
keyText | string | 按鍵的鍵值。 |
keySource | 觸發(fā)當(dāng)前按鍵的輸入設(shè)備類型。 | |
deviceId | number | 觸發(fā)當(dāng)前按鍵的輸入設(shè)備ID。 |
metaKey | number | 按鍵發(fā)生時(shí)元鍵(即Windows鍵盤的WIN鍵、Mac鍵盤的Command鍵)的狀態(tài),1表示按壓態(tài),0表示未按壓態(tài)。 |
timestamp | number | 事件時(shí)間戳。觸發(fā)事件時(shí)距離系統(tǒng)啟動(dòng)的時(shí)間間隔,單位納秒。 |
stopPropagation | () => void | 阻塞事件冒泡傳遞。 |
- // 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)
- }
- }
Copyright©2021 w3cschool編程獅|閩ICP備15016281號(hào)-3|閩公網(wǎng)安備35020302033924號(hào)
違法和不良信息舉報(bào)電話:173-0602-2364|舉報(bào)郵箱:jubao@eeedong.com
掃描二維碼
下載編程獅App
編程獅公眾號(hào)
聯(lián)系方式:
更多建議: