PhoneGapAPI帮助文档翻译整理7Events 消息Word下载.docx
《PhoneGapAPI帮助文档翻译整理7Events 消息Word下载.docx》由会员分享，可在线阅读，更多相关《PhoneGapAPI帮助文档翻译整理7Events 消息Word下载.docx（15页珍藏版）》请在冰豆网上搜索。
如果你需要在android系统上重载缺省后退按钮的行为,你可以通过注册'
backbutton'
事件监听来达到这一目的,目前已经不需要为了重载后退按钮的行为而去调用其他任何方法。
现在，你只需为'
事件注册一个事件监听器就可以了
通常情况下,你需要在接收到'
deviceready'
消息后，使用document.addEventListener来建立这个时间的监听器
支持的平台
∙android
简单的例子
onBackKeyDown,false）;
functiononBackKeyDown（）{
//Handlethebackbuton
}
完整的例子
<
!
DOCTYPEHTMLPUBLIC"
-//W3C//DTDHTML4.01//EN"
"
http:
//www.w3.org/TR/html4/strict.dtd"
>
html>
head>
title>
PhoneGapDeviceReadyExample<
/title>
scripttype="
text/javascript"
charset="
utf-8"
src="
phonegap.js"
/script>
//CallonDeviceReadywhenPhoneGapisloaded.
//当PhoneGap加载完毕后调用onDeviceReady
//Atthispoint,thedocumenthasloadedbutphonegap.jshasnot.
//WhenPhoneGapisloadedandtalkingwiththenativedevice,
//itwillcalltheevent`deviceready`.
//现在这个时候，文档已经加载完毕，但是phonegap.js还没有加载完毕
//当PhoneGap加载完毕并且与原生设备并连接上后,phonegap会触发'
消息
functiononLoad（）{
deviceready"
onDeviceReady,false）;
}
//PhoneGapisloadedanditisnowsafetomakecallsPhoneGapmethods
//PhoneGap加载完毕,现在已经可以安全的调用PhoneGap的方法
functiononDeviceReady（）{
//Registertheeventlistener
//注册时间监听器
//Handlethebackbutton
//处理后退的动作
/head>
bodyonload="
onLoad（）"
/body>
/html>
deviceready
只有当PhoneGap被完全加载后这个消息才被发出
对于任何一个PhoneGap应用程序来说，这个消息都十分重要，是你一定要使用的
PhoneGap包含两套代码库:
原生代码库以及JavaScript代码库.当原生代码加载的时候，表示正在加载的图片会被现实出来。
不过，JavaScript一旦DOM加载，JAVASCRIPT也会加载.这就是说你的WEB应用程序有一定的可能性在PhoneGap原生库加载完毕之前就可以调用一个PhoneGapJavaScript函数
PhoneGap一旦完成加载就会发出一个deviceready消息.当设备发出这个消息后，你就可以很安全的调用PhoneGap的函数了
一般来说，你应当在HTMLdocument'
sDOM加载时使用document.addEventListener为系统增加一个消息监听器
∙Android
∙BlackBerryWebWorks（OS5.0andhigher）
∙iPhone
//NowsafetousethePhoneGapAPI
//现在使用PhoneGapAPI就安全了
//这个时候,文档已经加载完毕，但是phonegap.js还没有加载完毕
//PhoneGap加载完毕并且可以安全调用PhoneGap的方法
//现在可以安全的使用PhoneGap的API
BlackBerry（OS4.6）的独特之处
RIM的（web浏览器视图）BrowserField不支持自定义消息，所以deviceready不会被触发
一个解决方法是手动查询PhoneGap.available，直到PhoneGap已经完全加载。
//BlackBerryOS4browserdoesnotsupportevents.
//So,manuallywaituntilPhoneGapisavailable.
//BlackBerryOS4浏览器不支持这个消息
//因此我们用手动方式等待，直到PhoneGap加载完毕
varintervalID=window.setInterval（
function（）{
if（PhoneGap.available）{
window.clearInterval（intervalID）;
onDeviceReady（）;
},
500
）;
//现在可以安全的使用PhoneGapAPI
menubutton
当用户在Android系统上点击菜单按钮的时候触发此事件。
viewplaincopytoclipboardprint?
menubutton"
详述
如果你需要在Android系统上重载默认菜单按钮的行为，可以通过注册一个事件监听器来监听“menubutton”事件。
通常情况下，你需要在接受到PhoneGap的“deviceready”事件后，使用document.addEventListener来附加该事件监听器。
∙Android
简单的范例
onMenuKeyDown,false）;
functiononMenuKeyDown（）{
//处理菜单按钮操作
}
完整的范例
//当PhoneGap加载完毕后调用onDeviceReady回调函数
//此时，该文件已加载完毕但phonegap.js还没有加载完毕。
//当PhoneGap加载完毕并开始和本地设备进行通讯，
//会触发“deviceready”事件
//PhoneGap加载完毕，现在可以安全地调用PhoneGap方法
functiononDeviceReady（）{
//注册菜单按钮事件监听器
//处理菜单按钮操作
pause
当PhoneGap程序被放到后台的时候触发此事件
pause"
PhoneGap基于两种代码：
原生以及javascript。
当原生代码将应用程序放到后台的时候,暂停时间被触发。
通常情况下,你需要在接收到PhoneGap的'
消息后，使用document.addEventListener增加一个事件监听器
支持的平台:
简单的例子:
onPause,false）;
functiononPause（）{
//Handlethepauseevent
//处理暂停事件
完整的例子:
//PhoneGap已经加载完毕，并且现在已经可以安全的调用PhoneGap的方法了
iOS的特别之处
在暂停事件处理过程中,任何对Objective-C的调用都不会工作。
任何调用也不会产生交互，例如alerts。
这意味着你不能调用console.log（及其变种）,任何插件的调用或者PhoneGapAPI的调用也不会有所动作。
这些调用将在应用等程序回复的时候被处理（在下一次运行的时候处理）
resume
当应用程序从后台回复到前台运行的时候触发此事件
resume"
onResume,false）;
functiononResume（）{
//Handletheresumeevent
//处理恢复事件
online
当PhoneGap应用程序在线（连接到因特网）的时候触发此事件。
online"
当应用程序的网络连接改变为online的时候触发online事件。
通常情况下，你会希望一旦接收到PhoneGap的“deviceready”事件就使用document.addEventListener附加一个事件监听器。
∙BlackBerryWebWorks（OS5.0或更高版本）
∙iPhone
onOnline,false）;
functiononOnline（）{
//处理online事件
完整的范例：
DOCTYPEhtml>
//当PhoneGap加载完毕后调用onDeviceReady回调函数。
//就会触发“deviceready”事件。
//PhoneGap加载完毕，现在可以安全地调用PhoneGap方法。
functiononDeviceReady（）{
body>
iOS的特异情况
在初次启动的情况下，第一个online事件（如果有的话）将需要至少1秒钟才被触发。
offline
当PhoneGap应用程序离线（没有连接到因特网）的时候触发此事件。
offline"
当应用程序的网络连接改变为offline的时候触发offline事件。
onOffline,false）;
functiononOffline（）{
//处理offline事件
PhoneGapDeviceRe
升级会员 