key
Key管理设备按键事件
方法:
- addEventListener: 添加按键事件监听器
- hideSoftKeybord: 隐藏软键盘
- setAssistantType: 设置辅助输入类型
- showSoftKeybord: 显示软键盘
- removeEventListener: 移除按键事件监听器
对象:
回调方法:
- KeyEventCallback: 按键事件的回调函数
权限:
5+功能模块(permissions)
{ // ... "permissions":{ // ... "Webview": { "description": "窗口管理" } } }
KeyType
按键类型
常量:
- "backbutton": (String
类型
)设备“返回”按钮按键事件
如果需要改变默认“返回”按钮的处理逻辑,则可通过plus.key.addEventListener来注册监听"backbutton"事件。
- "keydown": (String
类型
)键按下事件
如果需要改变默认键按下的处理逻辑,则可通过plus.key.addEventListener来注册监听"keydown"事件。 可通过回调函数中KeyEvent对象的keyCode来获取按下的键值。
- "keyup": (String
类型
)键松开事件
如果需要改变默认键松开的处理逻辑,则可通过plus.key.addEventListener来注册监听"keyup"事件。 可通过回调函数中KeyEvent对象的keyCode来获取松开的键值。
- "longpressed": (String
类型
)长按键事件
如果需要改变默认长按键的处理逻辑,则可通过plus.key.addEventListener来注册监听"longpressed"事件。 长按键时会多次触发回调函数,通过回调函数中KeyEvent对象的keyCode来获取长按的键值。
- "menubutton": (String
类型
)设备“菜单”按钮按键事件
如果需要改变默认“菜单”按钮的处理逻辑,则可通过plus.key.addEventListener来注册监听"menubutton"事件。
- "searchbutton": (String
类型
)设备“搜索”按钮按键事件
如果需要改变默认“搜索”按钮的处理逻辑,则可通过plus.key.addEventListener来注册监听"searchbutton"事件。
- "volumeupbutton": (String
类型
)设备“音量+”按钮按键事件
如果需要改变默认“音量+”按钮的处理逻辑,则可通过plus.key.addEventListener来注册监听"volumeupbutton"事件。
- "volumedownbutton": (String
类型
)设备“音量-”按钮按键事件
如果需要改变默认“音量-”按钮的处理逻辑,则可通过plus.key.addEventListener来注册监听"volumedownbutton"事件。
KeyEvent
按键事件
属性:
- keyCode: (Number
类型
)触发按键事件的键值
键值由各系统平台定义,一些特殊按键在不同的设备上可能存在差异。
- keyType: (KeyType
类型
)按键事件类型
用于表明触发此按键事件的类型,值为KeyType中定义的值。
KeyEventCallback
按键事件的回调函数
void onKeyEvent( KeyEvent event ){ // Event handled code. var key=event.keyCode; // 用户按键的键值 }
参数:
- event:
(
KeyEvent
)
必选 监听用户按键操作返回的数据
可通过event的keyCode属性(String类型)获取用户按键的类型,参考KeyType类型。