Key

稿件来源: 互联网   撰稿作者: 匿名   发表日期: 2015-03-23   阅读次数: 14   查看权限: 游客查看

Key管理设备按键事件

方法:

对象:

回调方法:

addEventListener

添加按键事件监听器

plus.key.addEventListener( keyevent, listener, capture );

说明:

添加按键事件监听器,当指定的按键事件发生时,回调函数将触发。 应用中存在多个Webview窗口时,按照窗口的显示栈顺序从后往前查找,查找到添加按键事件监听器的窗口后停止(中断前面Webview窗口对按键事件的监听),并向窗口触发执行按键回调事件。 在同一Webview窗口中可多次调用此方法对同一事件添加多个监听器,触发时按照添加的顺序先后调用。

参数:

  • event (KeyType) 可选 要监听的按键事件类型
  • listener (KeyEventCallback) 可选 监听按键事件发生时调用的回调函数
  • capture (Boolean) 可选 捕获按键事件流顺序,暂作为保留参数

返回值:

示例:

<!DOCTYPE html>
<html>
	<head>
	<meta charset="utf-8">
	<title>Key Example</title>
	<script type="text/javascript">
// 监听“返回”按钮事件
function addEventTest() {
	plus.key.addEventListener("backbutton",function(){
		alert( "BackButton Key pressed!" );
	});
}
	</script>
	</head>
	<body>
		<button onclick="addEventTest()">监听“返回”按键</button>
	</body>
</html>

removeEventListener

移除按键事件监听器

plus.key.removeEventListener( event, listener );

说明:

从窗口移除指定的事件监听器。若没有查找到对应的事件监听器,则无任何作用。

参数:

  • event (KeyType) 可选 要移除的事件类型
  • listener (EventCallback) 可选 要移除回调函数对象

返回值:

示例:

<!DOCTYPE html>
<html>
	<head>
	<meta charset="utf-8">
	<title>Key Example</title>
	<script type="text/javascript">
function onback(){
	alert( "BackButton Key pressed!" );
}
// 监听“返回”按钮事件
function addEventTest() {
	plus.key.addEventListener("backbutton",onback);
}
// 取消监听“返回”按钮事件
function removeEventTest(){
	plus.key.removeEventListener("backbutton",onback);
}
	</script>
	</head>
	<body>
		<button onclick="addEventTest()">监听“返回”按键</button>
		<button onclick="removeEventTest()">取消监听“返回”按键</button>
	</body>
</html>

KeyType

按键类型

常量:

平台支持:

平台支持:

平台支持:

平台支持:

平台支持:

平台支持:

平台支持:

平台支持:

"backbutton"

设备“返回”按钮按键事件

说明:

如果需要改变默认“返回”按钮的处理逻辑,则可通过plus.key.addEventListener来注册监听"backbutton"事件。

平台支持:

Android : 2.2+

默认处理逻辑为退出应用。

WP : 7.5+

默认处理逻辑为退出应用。

"keydown"

键按下事件

说明:

如果需要改变默认键按下的处理逻辑,则可通过plus.key.addEventListener来注册监听"keydown"事件。 可通过回调函数中KeyEvent对象的keyCode来获取按下的键值。

平台支持:

Android : 2.2+

默认处理逻辑由系统决定。

"keyup"

键松开事件

说明:

如果需要改变默认键松开的处理逻辑,则可通过plus.key.addEventListener来注册监听"keyup"事件。 可通过回调函数中KeyEvent对象的keyCode来获取松开的键值。

平台支持:

Android : 2.2+

默认处理逻辑由系统决定。

"longpressed"

长按键事件

说明:

如果需要改变默认长按键的处理逻辑,则可通过plus.key.addEventListener来注册监听"longpressed"事件。 长按键时会多次触发回调函数,通过回调函数中KeyEvent对象的keyCode来获取长按的键值。

平台支持:

Android : 2.2+

默认处理逻辑由系统决定。

"menubutton"

设备“菜单”按钮按键事件

说明:

如果需要改变默认“菜单”按钮的处理逻辑,则可通过plus.key.addEventListener来注册监听"menubutton"事件。

平台支持:

Android : 2.2+

默认处理逻辑无操作。

"searchbutton"

设备“搜索”按钮按键事件

说明:

如果需要改变默认“搜索”按钮的处理逻辑,则可通过plus.key.addEventListener来注册监听"searchbutton"事件。

平台支持:

Android : 2.2+

默认处理逻辑为打开系统搜索应用。

"volumeupbutton"

设备“音量+”按钮按键事件

说明:

如果需要改变默认“音量+”按钮的处理逻辑,则可通过plus.key.addEventListener来注册监听"volumeupbutton"事件。

平台支持:

Android : 2.2+

默认处理逻辑为增加系统音量。

"volumedownbutton"

设备“音量-”按钮按键事件

说明:

如果需要改变默认“音量-”按钮的处理逻辑,则可通过plus.key.addEventListener来注册监听"volumedownbutton"事件。

平台支持:

Android : 2.2+

默认处理逻辑为减少系统音量。

KeyEvent

按键事件

属性:

  • keyCode:Number,键值由各系统平台定义,一些特殊按键在不同的设备上可能存在差异。
  • keyType:KeyType,用于表明触发此按键事件的类型,值为KeyType中定义的值。

KeyEventCallback

按键事件的回调函数

void onKeyEvent( KeyEvent event ){
	// Event handled code.
	var key=event.keyCode; // 用户按键的键值
}

说明:

按键事件的回调函数

参数:

  • event (KeyEvent) 可选 可通过event的keyCode属性(String类型)获取用户按键的类型,参考KeyType类型。

关键词: html5puls,Key   编辑时间: 2015-03-23 23:16:30

  • 感到高兴

    0

    高兴
  • 感到支持

    0

    支持
  • 感到搞笑

    0

    搞笑
  • 感到不解

    0

    不解
  • 感到谎言

    0

    谎言
  • 感到枪稿

    0

    枪稿
  • 感到震惊

    0

    震惊
  • 感到无奈

    0

    无奈
  • 感到无聊

    0

    无聊
  • 感到反对

    0

    反对
  • 感到愤怒

    0

    愤怒
0%(0)
0%(0)
上一篇:IO
下一篇:Maps
  • 百度搜索引擎 中搜索:Key
  • google搜索引擎 中搜索:Key
共有0 条评论 发言请遵守【相关规定

网友评论

会员头像
发 表同步腾讯微博    验证码:  点击更新请先登陆
  • 暂无评论
关闭模块文章图片 article Pictrue
  • 我的妈妈爸爸
  • 基于koa2+mysql+vue2.0+Element阳光内容管理系统
  • 代码覆盖率工具 Istanbul 入门教程
  • 全栈工程师的武器——MEAN
  • 9款超炫的 CSS3 复选框(Checkbox)
  • 微信开发在线翻译功能
  • CSS3那些不为人知的高级属性
  • 给easyui的datebox添加清空事件
  • flash写字效果
  • kendoUI系列教程之DropDownList下拉菜单
  • kendoUI系列教程之datetimepicker日期时间选择
  • kendoUI系列教程之datepicker日期选择
  • kendoUI系列教程之combobox下拉列表框
  • kendoUI系列教程之colorpicker
  • kendoUI系列教程之calendar日历表
  • kendoUI系列教程之autocomplete自动补齐