zhichen-edu
/
zc_saas_h5


			
				
					
						
						
							123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675
							<!DOCTYPE HTML>
<html>
<head>
<meta charset="utf-8">
<meta name="viewport" content="initial-scale=1.0, minimum-scale=1.0, maximum-scale=1.0, user-scalable=no">
<meta name="HandheldFriendly" content="true">
<meta name="MobileOptimized" content="320">
<title>NativeUI Document</title>
<link rel="stylesheet" type="text/css" href="res/doc.css" charset="utf-8">
<link rel="stylesheet" type="text/css" href="res/prettify.sons.css" charset="utf-8">
<script type="text/javascript" src="res/doc.js" charset="utf-8"></script><script type="text/javascript" src="res/prettify.js" charset="utf-8"></script>
</head>
<body><div id="content" class="content">
<h1><a name="plus.nativeUI">nativeUI</a></h1>
<p>nativeUI管理系统原生界面，可用于弹出系统原生提示对话框窗口、时间日期选择对话框、等待对话框等。</p>
<h2>方法：</h2>
<ul>
<li>
<a href="#plus.nativeUI.actionSheet">actionSheet</a>: 弹出系统选择按钮框</li>
<li>
<a href="#plus.nativeUI.alert">alert</a>: 弹出系统提示对话框</li>
<li>
<a href="#plus.nativeUI.confirm">confirm</a>: 弹出系统确认对话框</li>
<li>
<a href="#plus.nativeUI.closeWaiting">closeWaiting</a>: 关闭系统等待对话框</li>
<li>
<a href="#plus.nativeUI.closeToast">closeToast</a>: 关闭自动消失的提示消息</li>
<li>
<a href="#plus.nativeUI.previewImage">previewImage</a>: 预览图片</li>
<li>
<a href="#plus.nativeUI.showWaiting">showWaiting</a>: 显示系统等待对话框</li>
<li>
<a href="#plus.nativeUI.pickDate">pickDate</a>: 弹出系统日期选择对话框</li>
<li>
<a href="#plus.nativeUI.pickTime">pickTime</a>: 弹出系统时间选择对话框</li>
<li>
<a href="#plus.nativeUI.prompt">prompt</a>: 弹出系统输入对话框</li>
<li>
<a href="#plus.nativeUI.toast">toast</a>: 显示自动消失的提示消息</li>
</ul>
<h2>对象：</h2>
<ul>
<li>
<a href="#plus.nativeUI.ActionButtonStyles">ActionButtonStyles</a>: JSON对象，原生选择按钮框上按钮的样式参数</li>
<li>
<a href="#plus.nativeUI.ActionSheetStyles">ActionSheetStyles</a>: JSON对象，原生选择按钮框的样式参数</li>
<li>
<a href="#plus.nativeUI.ConfirmStyles">ConfirmStyles</a>: 确认对话框的参数</li>
<li>
<a href="#plus.nativeUI.PreviewImageStyles">PreviewImageStyles</a>: JSON对象，图片预览的参数</li>
<li>
<a href="#plus.nativeUI.PickDateStyles">PickDateStyles</a>: 日期选择对话框的参数</li>
<li>
<a href="#plus.nativeUI.PickTimeStyles">PickTimeStyles</a>: JSON对象，时间选择对话框的参数</li>
<li>
<a href="#plus.nativeUI.NativeUIObj">NativeUIObj</a>: 系统原生界面基类对象</li>
<li>
<a href="#plus.nativeUI.WaitingObj">WaitingObj</a>: 系统等待对话框对象</li>
<li>
<a href="#plus.nativeUI.WaitingStyles">WaitingStyles</a>: JSON对象，原生等待对话框的参数</li>
<li>
<a href="#plus.nativeUI.WaitingLoadingStyles">WaitingLoadingStyles</a>: JSON对象，原生等待对话框上loading图标自定义样式</li>
<li>
<a href="#plus.nativeUI.ToastStyles">ToastStyles</a>: JSON对象，系统提示消息框要设置的参数</li>
</ul>
<h2>回调方法：</h2>
<ul>
<li>
<a href="#plus.nativeUI.ActionSheetCallback">ActionSheetCallback</a>: 系统选择按钮框的回调函数</li>
<li>
<a href="#plus.nativeUI.AlertCallback">AlertCallback</a>: 系统提示框确认的回调函数</li>
<li>
<a href="#plus.nativeUI.ConfirmCallback">ConfirmCallback</a>: 关闭确认对话框的回调函数</li>
<li>
<a href="#plus.nativeUI.PromptCallback">PromptCallback</a>: 系统输入对话框关闭后的回调函数</li>
<li>
<a href="#plus.nativeUI.PickDatetimeSuccessCallback">PickDatetimeSuccessCallback</a>: 选择日期或时间操作成功的回调函数</li>
<li>
<a href="#plus.nativeUI.PickDatetimeErrorCallback">PickDatetimeErrorCallback</a>: 选择日期或时间操作取消或失败的回调函数</li>
<li>
<a href="#plus.nativeUI.PreviewImageLongPressCallback">PreviewImageLongPressCallback</a>: 图片预览长按事件</li>
</ul>
<h2>权限：</h2>
<p>5+功能模块（permissions）</p>
<pre class="prettyprint linenums">
{
// ...
"permissions":{
	// ...
	"NativeUI": {
		"description": "原生UI控件"
	}
}
}
			</pre>
<h1><a name="plus.nativeUI.ActionButtonStyles">ActionButtonStyles</a></h1>
<p>JSON对象，原生选择按钮框上按钮的样式参数</p>
<h2>属性：</h2>
<ul>
<li>color: <em>(<font class="type">String</font>
	类型
)</em>按钮上显示的文字颜色<br><p>
	可取值：
	"#RRGGBB"格式字符串，如"#FF0000"表示文字颜色为红色；
	"rgba(R,G,B,A)"，其中R/G/B分别代表红色值/绿色值/蓝色值，正整数类型，取值范围为0-255，A为透明度，浮点数类型，取值范围为0-1（0为全透明，1为不透明），如"rgba(255,0,0,0.5)"，表示红色半透明。
						</p>
</li>
<li>title: <em>(<font class="type">String</font>
	类型
)</em>按钮上显示的文字内容<br>
</li>
<li>style: <em>(<font class="type">String</font>
	类型
)</em>按钮的样式<br><p>
	可取值：
	"destructive" - 表示警示按钮样式，默认文字颜色为红色；
	"default" - 表示默认按钮样式。
	默认值为"default"。
						</p>
</li>
</ul>
<h1><a name="plus.nativeUI.ActionSheetStyles">ActionSheetStyles</a></h1>
<p>JSON对象，原生选择按钮框的样式参数</p>
<h2>属性：</h2>
<ul>
<li>title: <em>(<font class="type">String</font>
	类型
)</em>选择按钮框的标题<br>
</li>
<li>cancel: <em>(<font class="type">String</font>
	类型
)</em>取消按钮上显示的文字内容<br><p>
	不设置此属性，则不显示取消按钮。
						</p>
</li>
<li>buttons: <em>(<font class="type">Array</font>[
				<a href="#plus.nativeUI.ActionButtonStyles">ActionButtonStyles</a>
				]
			
	类型
)</em>选择框上的按钮，ActionButtonStyles对象数组<br>
</li>
</ul>
<h1><a name="plus.nativeUI.ConfirmStyles">ConfirmStyles</a></h1>
<p>确认对话框的参数</p>
<h2>属性：</h2>
<ul>
<li>title: <em>(<font class="type">String</font>
	类型
)</em>确认对话框显示的标题<br><p>
	如果不设置此属性值，则不显示标题。
						</p>
</li>
<li>buttons: <em>(<font class="type">Array</font>[
				<font class="type">String</font>
				]
			
	类型
)</em>确认对话框上显示的按钮<br><p>
	字符串数组，每项对应在确认对话框上显示一个按钮，用户点击后通过confirmCB返回用户点击按钮的在数组中的索引值。
						</p>
</li>
<li>verticalAlign: <em>(<font class="type">String</font>
	类型
)</em>对话框在屏幕中的垂直分享对齐方式<br><p>
	可取值：
		"top" - 表示垂直居顶对齐；
		"center" - 表示垂直居中对齐；
		"bottom" - 表示垂直居底对齐。
	默认值为"center"（垂直居中对齐）。
						</p>
</li>
</ul>
<h1><a name="plus.nativeUI.PreviewImageStyles">PreviewImageStyles</a></h1>
<p>JSON对象，图片预览的参数</p>
<h2>属性：</h2>
<ul>
<li>background: <em>(<font class="type">String</font>
	类型
)</em>图片预览的背景颜色<br><p>
	颜色值格式为"#RRGGBB"，如"#FF0000"表示为红色背景。
	默认值为黑色（"#000000"）。
						</p>
</li>
<li>current: <em>(<font class="type">Number</font>
	类型
)</em>默认显示图片的索引值<br><p>
	索引值从0开始，默认值为0。
						</p>
</li>
<li>indicator: <em>(<font class="type">String</font>
	类型
)</em>图片指示器样式<br><p>
	可取值：
		"default" - 默认指示器（底部圆点样式）；
		"number" - 顶部数字指示器（顶部居中显示，文字为%当前图片索引值（从1开始）%/%图片总数%）；
		"none" - 不显示指示器。
	默认值为"default"。
						</p>
</li>
<li>loop: <em>(<font class="type">Boolean</font>
	类型
)</em>是否可循环预览<br><p>
	可取值：
		"true" - 支持循环预览；
		"false" - 不支持循环预览。
	默认值为"false"。
						</p>
</li>
<li>onLongPress: <em>(<a href="#plus.nativeUI.PreviewImageLongPressCallback">PreviewImageLongPressCallback</a>
	类型
)</em>长按事件<br><p>
	用户在图片预览界面长按时触发。
	在回调中返回长按图片的信息（索引值、地址等）。
	由于图片预览界面是层级非常高的窗口，此时只能调用plus.nativeUI.*显示的窗口覆盖在图片预览界面上（原生控件plus.nativeObj.View也无法显示）。
	注意：HBuilderX1.9.5及以上版本支持。
						</p>
</li>
</ul>
<h1><a name="plus.nativeUI.PickDateStyles">PickDateStyles</a></h1>
<p>日期选择对话框的参数</p>
<h2>属性：</h2>
<ul>
<li>title: <em>(<font class="type">String</font>
	类型
)</em>日期选择对话框显示的标题<br><p>
	如果未设置，则不显示标题。
						</p>
</li>
<li>date: <em>(<font class="type">Date</font>
	类型
)</em>日期选择对话框默认显示的日期<br><p>
	如果未设置，则显示当前的日期。
						</p>
</li>
<li>minDate: <em>(<font class="type">Date</font>
	类型
)</em>日期选择对话框可选择的最小日期<br><p>
	Date类型对象，如果未设置可选择的最小日期，则使用系统默认可选择的最小日期值。
						</p>
</li>
<li>maxDate: <em>(<font class="type">Date</font>
	类型
)</em>日期选择对话框可选择的最大日期<br><p>
	Date类型对象，如果未设置可选择的最大日期，则使用系统默认可选择的最大日期值。
	其值必须大于minDate设置的值，否则使用系统默认可选择的最大日期值。
						</p>
</li>
<li>popover: <em>(<font class="type">JSON</font>
	类型
)</em>时间选择对话框弹出指示区域<br><p>
	JSON类型对象，格式如{top:10;left:10;width:200;height:200;}，所有值为像素值，其值为相对于容器Webview的位置。
	如未设置此值，默认在屏幕居中显示。仅在iPad上有效，其它设备忽略此值。
						</p>
</li>
</ul>
<h1><a name="plus.nativeUI.PickTimeStyles">PickTimeStyles</a></h1>
<p>JSON对象，时间选择对话框的参数</p>
<h2>属性：</h2>
<ul>
<li>time: <em>(<font class="type">Date</font>
	类型
)</em>时间选择对话框默认显示的时间<br><p>
	如果未设置，则默认当前的时间。
						</p>
</li>
<li>title: <em>(<font class="type">String</font>
	类型
)</em>时间选择对话框显示的标题<br><p>
	如果未设置，则不显示标题。
						</p>
</li>
<li>is24Hour: <em>(<font class="type">Boolean</font>
	类型
)</em>是否24小时制模式<br><p>
	true表示使用24小时制模式显示，fale表示使用12小时制模式显示，默认值为true。
						</p>
</li>
<li>popover: <em>(<font class="type">JSON</font>
	类型
)</em>日期选择对话框弹出指示区域<br><p>
	JSON类型对象，格式如{top:10;left:10;width:200;height:200;}，所有值为像素值，其值相对于容器webview的位置。
	如未设置此值，默认在屏幕居中显示。仅在iPad上有效，其它设备忽略此值。
						</p>
</li>
</ul>
<h1><a name="plus.nativeUI.NativeUIObj">NativeUIObj</a></h1>
<p>系统原生界面基类对象</p>
<pre class="prettyprint linenums">
interface NativeUIObj{
	function void close();
}
				</pre>
<h2>方法：</h2>
<ul><li>
<a href="#plus.nativeUI.NativeUIObj.close">close</a>: 关闭显示的系统原生界面</li></ul>
<h1><a name="plus.nativeUI.WaitingObj">WaitingObj</a></h1>
<p>系统等待对话框对象</p>
<h2>说明：</h2>
<p class="des">
	从NativeUIObj对象继承而来，通过plus.nativeUI.showWaiting方法创建时返回。
	用于控制系统样式等待对话框的操作，如关闭、设置标题内容等。
				</p>
<h2>方法：</h2>
<ul>
<li>
<a href="#plus.nativeUI.WaitingObj.setTitle">setTitle</a>: 设置等待对话框上显示的文字内容</li>
<li>
<a href="#plus.nativeUI.WaitingObj.close">close</a>: 关闭显示的系统等待对话框</li>
</ul>
<h2>事件：</h2>
<ul><li>
<a href="#plus.nativeUI.WaitingObj.onclose">onclose</a>: 等待对话框关闭事件</li></ul>
<h1><a name="plus.nativeUI.WaitingStyles">WaitingStyles</a></h1>
<p>JSON对象，原生等待对话框的参数</p>
<h2>属性：</h2>
<ul>
<li>width: <em>(<font class="type">String</font>
	类型
)</em>等待框背景区域的宽度<br><p>
	值支持像素值（"500px"）或百分比（"50%"），百分比相对于屏幕的宽计算，如果不设置则根据内容自动计算合适的宽度。
						</p>
</li>
<li>height: <em>(<font class="type">String</font>
	类型
)</em>等待框背景区域的高度<br><p>
	值支持像素绝对值（"500px"）或百分比（"50%"），如果不设置则根据内容自动计算合适的高度。
						</p>
</li>
<li>color: <em>(<font class="type">String</font>
	类型
)</em>等待框中文字的颜色<br><p>
	颜色值支持(参考CSS颜色规范)：颜色名称(参考CSS Color Names)/十六进制值/rgb值/rgba值，默认值为白色。
						</p>
</li>
<li>size: <em>(<font class="type">String</font>
	类型
)</em>等待框中文字的字体大小<br><p>
	如"14px"表示使用14像素高的文字，未设置则使用系统默认字体大小。
						</p>
</li>
<li>textalign: <em>(<font class="type">String</font>
	类型
)</em>等待对话框中标题文字的水平对齐方式<br><p>
	对齐方式可选值包括："left"：水平居左对齐显示，"center"：水平居中对齐显示，"right"：水平居右对齐显示。默认值为水平居中对齐显示，即"center"。
						</p>
</li>
<li>padding: <em>(<font class="type">String</font>
	类型
)</em>等待对话框的内边距<br><p>
	值支持像素值（"10px"）和百分比（"5%"），百分比相对于屏幕的宽计算，默认值为"3%"。
						</p>
</li>
<li>background: <em>(<font class="type">String</font>
	类型
)</em>等待对话框显示区域的背景色<br><p>
	背景色的值支持(参考CSS颜色规范)：颜色名称(参考CSS Color Names)/十六进制值/rgb值/rgba值，默认值为rgba(0,0,0,0.7)。
						</p>
</li>
<li>style: <em>(<font class="type">String</font>
	类型
)</em>等待对话框样式<br><p>
	可取值"black"、"white"，black表示等待框为黑色雪花样式，通常在背景主色为浅色时使用；white表示等待框为白色雪花样式，通常在背景主色为深色时使用。
	仅在iOS平台有效，其它平台忽略此值，未设置时默认值为white。
						</p>
</li>
<li>modal: <em>(<font class="type">Boolen</font>
	类型
)</em>等待框是否模态显示<br><p>
	模态显示时用户不可操作直到等待对话框关闭，否则用户在等待对话框显示时也可操作下面的内容，未设置时默认为true。
						</p>
</li>
<li>round: <em>(<font class="type">Number</font>
	类型
)</em>等待框显示区域的圆角<br><p>
	值支持像素值（"10px"），未设置时使用默认值"10px"。
						</p>
</li>
<li>padlock: <em>(<font class="type">Boolen</font>
	类型
)</em>点击等待显示区域是否自动关闭<br><p>
	true表示点击等待对话框显示区域时自动关闭，false则不关闭，未设置时默认值为false。
						</p>
</li>
<li>back: <em>(<font class="type">String</font>
	类型
)</em>返回键处理方式<br><p>
	可取值"none"表示截获处理返回键，但不做任何响应；"close"表示截获处理返回键并关闭等待框；"transmit"表示不截获返回键，向后传递给Webview窗口继续处理（与未显示等待框的情况一致）。
						</p>
</li>
<li>loading: <em>(<a href="#plus.nativeUI.WaitingLoadingStyles">WaitingLoadingStyles</a>
	类型
)</em>自定义等待框上loading图标样式<br>
</li>
</ul>
<h1><a name="plus.nativeUI.WaitingLoadingStyles">WaitingLoadingStyles</a></h1>
<p>JSON对象，原生等待对话框上loading图标自定义样式</p>
<h2>属性：</h2>
<ul>
<li>display: <em>(<font class="type">String</font>
	类型
)</em>loading图标显示样式<br><p>
	可取值：
	"block"表示图标与文字分开两行显示，上面显示loading图标，下面显示文字；
	"inline"表示loading图标与文字在同一行显示，左边显示loading图标，右边显示文字；
	"none"表示不显示loading图标；
						</p>
</li>
<li>height: <em>(<font class="type">String</font>
	类型
)</em>loading图标高度<br><p>
	设置loading图标的高度（宽度等比率缩放），取值类型：像素值，如"14px"表示14像素高。
						</p>
</li>
<li>icon: <em>(<font class="type">String</font>
	类型
)</em>loading图标路径<br><p>
	自定义loading图标的路径，png格式，并且必须是本地资源地址；
	loading图要求宽是高的整数倍，显示等待框时按照图片的高横向截取每帧刷新。
						</p>
</li>
<li>interval: <em>(<font class="type">Number</font>
	类型
)</em>loading图每帧刷新间隔<br><p>
	单位为ms（毫秒），默认值为100ms。
						</p>
</li>
<li>type: <em>(<font class="type">String</font>
	类型
)</em>loading图标类型<br><p>
	如果设置了icon属性，则优先使用icon自定义图标。
	可取值：
		"circle" - 圆圈类型loading图标；
		"snow" - 雪花类型loading图标。
	默认值为"circle"。
						</p>
</li>
</ul>
<h1><a name="plus.nativeUI.ToastStyles">ToastStyles</a></h1>
<p>JSON对象，系统提示消息框要设置的参数</p>
<h2>属性：</h2>
<ul>
<li>align: <em>(<font class="type">String</font>
	类型
)</em>提示消息框在屏幕中的水平位置<br><p>
	可选值为"left"、"center"、"right"，分别为水平居左、居中、居右，未设置时默认值为"center"。
						</p>
</li>
<li>background: <em>(<font class="type">String</font>
	类型
)</em>提示消息框的背景色<br><p>
	背景色的值支持(参考CSS颜色规范)：颜色名称(参考CSS Color Names)/十六进制值/rgb值/rgba值。
						</p>
</li>
<li>duration: <em>(<font class="type">String</font>
	类型
)</em>提示消息框显示的时间<br><p>
	可选值为"long"、"short"，值为"long"时显示时间约为3.5s，值为"short"时显示时间约为2s，未设置时默认值为"short"。
						</p>
</li>
<li>icon: <em>(<font class="type">String</font>
	类型
)</em>提示消息框上显示的图标<br><p>
	仅支持本地图片路径。
						</p>
</li>
<li>iconWidth: <em>(<font class="type">String</font>
	类型
)</em>图标的宽度<br><p>
	单位为px（逻辑像素值），默认值为图片的宽度。
						</p>
</li>
<li>iconHeight: <em>(<font class="type">String</font>
	类型
)</em>图标的高度<br><p>
	单位为px（逻辑像素值），默认值为图片的高度。
						</p>
</li>
<li>style: <em>(<font class="type">String</font>
	类型
)</em>提示消息框上显示的样式<br><p>
	可取值：
	"block"表示图标与文字分两行显示，上面显示图标，下面显示文字；
	"inline"表示图标与文字在同一行显示，左边显示图标，右边显示文字。
	默认值为"block"。
						</p>
</li>
<li>type: <em>(<font class="type">String</font>
	类型
)</em>提示消息框上显示的文本类型<br><p>
	可取值：
		"text" - 显示的消息内容为文本字符串；
		"richtext" - 显示的消息内容为富文本内容。
	默认值为"text"。
	当type为"text"时，富文本使用html的部分标签，具体标签如下：
	图片标签&lt;img src="图片资源url地址" width="图片显示的宽度" height="图片显示的高度" onclick="console.log('clicked img')"&gt;&lt;/img&gt;；
	字体标签&lt;font color="字体颜色"&gt;&lt;/font&gt;，内容在一行显示不下时自动换行，行高默认为字体的1.2倍；
	换行标签&lt;br/&gt;；
	链接标签&lt;a onclick="console.log('clicked a')"&gt;链接地址&lt;/a&gt;。
	如示例“&lt;img onclick="console.log('clicked img')" src="http://img-cdn-qiniu.dcloud.net.cn/icon2.png"/&gt;&lt;a onclick="console.log(clicked a)"&gt;链接地址&lt;/a&gt;”。

						</p>
</li>
<li>richTextStyle: <em>(<a href="#href.RichTextStyles">RichTextStyles</a>
	类型
)</em>富文本样式<br><p>
	当type属性值为"richtext"时有效，用于定义富文本的样式，如其文本对齐方式、使用的字体等。
						</p>
</li>
<li>verticalAlign: <em>(<font class="type">String</font>
	类型
)</em>提示消息在屏幕中的垂直位置<br><p>
	可选值为"top"、"center"、"bottom"，分别为垂直居顶、居中、居底，未设置时默认值为"bottom"。
						</p>
</li>
</ul>
<h1><a name="plus.nativeUI.ActionSheetCallback">ActionSheetCallback</a></h1>
<p>系统选择按钮框的回调函数</p>
<pre class="prettyprint linenums">
void onActioned( Event event ){
	// actionsheet handled code.
	var index=event.index; // 用户关闭时点击按钮的索引值
}
				</pre>
<h2>参数：</h2>
<ul><li>event: 
		<em>(
			<font class="type">Event</font>
			)
			必选 </em>用户操作选择按钮框关闭后返回的数据<br>
	可通过event.index（Number类型）获取用户关闭时点击按钮的索引值，索引值从0开始；
	0表示用户点击取消按钮，大于0值表示用户点击ActionSheetStyles中buttons属性定义的按钮，索引值从1开始（即1表示点击buttons中定义的第一个按钮）。
	通过API（close()方法）关闭，则回调函数中event的index属性值为-1。
						</li></ul>
<h2>返回值：</h2>
<font class="type">void</font>
			: 无<h1><a name="plus.nativeUI.AlertCallback">AlertCallback</a></h1>
<p>系统提示框确认的回调函数</p>
<pre class="prettyprint linenums">
void onAlerted( Event event ){
	// Alert handled code.
	var index=event.index; // 用户关闭提示对话框点击按钮的索引值
}
				</pre>
<h2>参数：</h2>
<ul><li>event: 
		<em>(
			<font class="type">Event</font>
			)
			必选 </em>用户操作确认对话框关闭后返回的数据<br>
	可通过event.index（Number类型）获取用户关闭确认对话框点击按钮的索引值，点击确认键的索引值为0。
	Android平台上通过返回按钮关闭时索引值为-1。
						</li></ul>
<h2>返回值：</h2>
<font class="type">void</font>
			: 无<h1><a name="plus.nativeUI.ConfirmCallback">ConfirmCallback</a></h1>
<p>关闭确认对话框的回调函数</p>
<pre class="prettyprint linenums">
void onConfirmed( Event event ) {
	// Confirm handled code.
	var index=event.index; // 用户关闭确认对话框点击按钮的索引值
}
				</pre>
<h2>参数：</h2>
<ul><li>event: 
		<em>(
			<font class="type">Event</font>
			)
			必选 </em>用户操作确认对话框关闭后返回的数据<br>
	可通过event.index（Number类型）获取用户关闭确认对话框点击按钮的索引值，索引值从0开始；
						</li></ul>
<h2>返回值：</h2>
<font class="type">void</font>
			: 无<h1><a name="plus.nativeUI.PromptCallback">PromptCallback</a></h1>
<p>系统输入对话框关闭后的回调函数</p>
<pre class="prettyprint linenums">
function void onPrompted( Event event ) {
	// Prompt handled code.
	var index=event.index; // 用户关闭输入对话框点击按钮的索引值
	var value=event.value; // 用户输入的内容
}
				</pre>
<h2>参数：</h2>
<ul><li>event: 
		<em>(
			<font class="type">Event</font>
			)
			必选 </em>用户操作输入对话框关闭后返回的数据<br>
	可通过event.index（Number类型）获取用户关闭输入对话框点击按钮的索引值，索引值从0开始；
	通过event.value（String类型）获取用户输入的内容，如果没有输入则返回空字符串。
						</li></ul>
<h2>返回值：</h2>
<font class="type">void</font>
			: 无<h1><a name="plus.nativeUI.PickDatetimeSuccessCallback">PickDatetimeSuccessCallback</a></h1>
<p>选择日期或时间操作成功的回调函数</p>
<pre class="prettyprint linenums">
function void onPickSuccess( Event event ) {
	// Date picked code.
	var date = event.date;// 用户选择的日期或时间
}
				</pre>
<h2>参数：</h2>
<ul><li>event: 
		<em>(
			<font class="type">Event</font>
			)
			必选 </em>用户完成选择日期或时间后返回的数据<br>
	可通过event.date（Date类型）获取选择的日期或时间值。
	若调用的是日期选择操作则仅年、月、日信息有效，若调用的是时间选择操作则仅时、分信息有效。
						</li></ul>
<h2>返回值：</h2>
<font class="type">void</font>
			: 无<h1><a name="plus.nativeUI.PickDatetimeErrorCallback">PickDatetimeErrorCallback</a></h1>
<p>选择日期或时间操作取消或失败的回调函数</p>
<pre class="prettyprint linenums">
function void onPickError( Exception error ) {
	// Date picked error.
	var code = error.code; // 错误编码
	var message = error.message; // 错误描述信息
}
				</pre>
<h2>参数：</h2>
<ul><li>error: 
		<em>(
			<font class="type">Exception</font>
			)
			必选 </em>用户选择操作失败信息<br>
	可通过error.code（Number类型）获取错误编码；
	可通过error.message（String类型）获取错误描述信息。
						</li></ul>
<h2>返回值：</h2>
<font class="type">void</font>
			: 无<h1><a name="plus.nativeUI.PreviewImageLongPressCallback">PreviewImageLongPressCallback</a></h1>
<p>图片预览长按事件</p>
<pre class="prettyprint linenums">
function void onlongPress(event) {
	// longpress event
	var index = event.index; 			// 长按图片的索引
	var url = event.url;					// 长按图片的url地址
	var path = event.path;				// 长按图片的本地图片路径（系统绝对路径）
}
				</pre>
<h2>说明：</h2>
<p class="des">
	在图片预览界面长按时触发。
				</p>
<h2>参数：</h2>
<ul>
<li>index: 
		<em>(
			<font class="type">Number</font>
			)
			必选 </em>长按图片的索引值<br>
	索引值从0开始。
						</li>
<li>url: 
		<em>(
			<font class="type">String</font>
			)
			必选 </em>长按图片的url地址<br>
	与调用plus.nativeUI.previewImage传入的urls值一致。
						</li>
<li>path: 
		<em>(
			<font class="type">String</font>
			)
			必选 </em>长按图片的本地地址<br>
	系统绝对路径。
						</li>
</ul>
<h2>返回值：</h2>
<font class="type">void</font>
			: 无<br><br>
</div></body>
</html>