nativeObj

nativeObj管理系统原生对象。

对象:

回调方法:

权限:

5+功能模块(permissions)

{
// ...
"permissions":{
	// ...
	"NativeObj": {
		"description": "原生对象"
	}
}
}
			

Bitmap

原生图片对象

interface Bitmap {
	readonly attribute String id;

	static function Array[Bitmap] getItems();
	static function Bitmap getBitmapById( id );
	
	function void clear();
	function void load( path, successCallback, errorCallback );
	function void loadBase64Data( data, successCallback, errorCallback );
	function void save( path, options, successCallback, errorCallback );
	function String toBase64Data();
}				

说明:

原生图片对象会占用较大的内存资源,在使用时需谨慎管理,当图片不再使用时应该及时调用clear方法进行销毁。

构造:

属性:

方法:

BitmapSaveOptions

JSON对象,保存图片的参数

interface BitmapSaveOptions {
	attribute Boolean overwrite;
	attribute String format;
	attribute Number quality;
	attribute Rect clip;
}				

属性:

View

原生控件对象

interface View {
	readonly attribute String id;

	static function void startAnimation(options, view, otherview, callback);
	static function void clearAnimation(type);
	static function View getViewById(id);

	function void addEventListener(event, listener, capture);
	function void animate(options, callback);
	function void close();
	function void clearRect(position, id);
	function void draw(tags);
	function void drawBitmap(src, sprite, position, id);
	function void drawRect(color, position, id);
	function void drawText(text, position, styles, id);
	function void reset();
	function void restore();
	function void show();
	function void setStyle(styles);
	function void setTouchEventRect(rect);
	function void hide();
	function void interceptTouchEvent(intercept);
	function Boolean isVisible();
}
				

说明:

原生控件对象可用于在屏幕上绘制图片或文本内容,当控件不再使用时需要调用clear方法销毁控件。

构造:

属性:

方法:

AnimationOptions

原生动画参数

interface AnimationOptions {
	attribute String type;
	attribute Number duration;
}				

说明:

指定动画的类型、持续时间等信息。

属性:

AnimationViewStyles

原生动画窗口样式

interface AnimationViewStyles {
	attribute Bitmap bitmap;
	attribute String text;
}				

说明:

指定动画窗口的样式,如背景图片,绘制的文字等。

属性:

Rect

区域信息对象

interface Rect {
	attribute String top;
	attribute String left;
	attribute String width;
	attribute String height;
}				

说明:

包括位置、大小等信息。

属性:

Position

区域信息对象

interface Position {
	attribute String top;
	attribute String left;
	attribute String width;
	attribute String height;
	attribute String bottom;
	attribute String right;
}				

说明:

包括位置、大小等信息。

属性:

TextStyles

文本样式对象

interface Rect {
	attribute String color;
	attribute String align;
	attribute String family;
	attribute String size;
	attribute String style;
	attribute String weight;
	attribute String fontSrc;
	attribute String overflow;
}				

说明:

用于定义文本的显示样式,如字体大小、字体颜色、字体粗细、字体样式、字体名称等信息。

属性:

ViewAnimationOptions

View控件动画参数

interface ViewAnimationOptions {
	attribute String type;
	attribute Number duration;
	attribute Number frames;
	attribute Rect region;
}				

说明:

指定动画的类型、持续时间等信息。

属性:

ViewDrawTagStyles

View控件绘制元素参数

interface ViewDrawTagStyles {
	attribute String id;
	attribute String tag;
	attribute String color;
	attribute Position position;
	attribute String src;
	attribute Position sprite;
	attribute String text;
	attribute TextStyles textStyles;
}				

说明:

指定绘制图片、矩形区域、文本内容等信息。

属性:

ViewEvents

View控件事件

常量:

ViewStatusbarStyles

JSON对象,View控件的系统状态栏区域样式

说明:

仅在应用设置为沉浸式状态栏样式下有效,非沉浸式状态栏样式下忽略此属性。

属性:

ViewStyles

View控件样式

interface ViewStyles {
	attribute String bottom;
	attribute String top;
	attribute String left;
	attribute String width;
	attribute String height;
	attribute String backgroundColor;
	attribute String dock;
	attribute String position;
	attribute Number opacity;
	attribute ViewStatusbarStyles statusbar;
}				

说明:

包括位置、大小等信息,位置信息相对于父容器控件进行计算。

属性:

BitmapSaveSuccessCallback

图片保存操作成功回调接口

void onSuccess( Event event ){
	// Code here
	var target = event.target; // 保存后的图片url路径,以"file://"开头
	var size = event.size; // 保存后图片的大小,单位为字节(Byte)
	var width = event.width; // 保存后图片的实际宽度,单位为px
	var height = event.height; // 保存后图片的实际高度,单位为px
}
				

参数:

返回值:

void : 无

TouchEventCallback

触屏事件的回调函数

void onEvent(Event e){
	// Event handled code.
	var clientX = e.clientX;
	var clientY = e.clientY;
	var pageX = e.pageX;
	var pageY = e.pageY;
	var screenX = e.screenX;
	var screenY = e.screenY;
	var target = e.target;
}
				

参数:

返回值:

void : 无

NativeObjSuccessCallback

操作成功回调函数接口

void onSuccess(){
	// Code here
}
				

参数:

返回值:

void : 无

NativeObjErrorCallback

操作错误回调函数接口

function void onError( Exception error ) {
	// Error.
	var code = error.code; // 错误编码
	var message = error.message; // 错误描述信息
}
				

参数:

返回值:

void : 无