Dorado 5 : 17.2.常用的JS函数以及对象 (RF1)

void showLoadingTip()

显示系统加载提示框。
执行耗时较长的任务时用于给出一个提示信息。

图表 100

void hideLoadingTip()

同上,用于隐藏系统加载提示框。

formatDate(Date date, String format)

日期类型格式化系统函数。

String formatDate(Date date, String format)

Date为js中的日期对象,format为格式化的表达式。
如: yyyy-MM-dd HH:ss:mm

var date = new Date();
var dateStr = formatDate(date, "yyyy-MM-dd HH:ss:mm");

系统显示为:2007-03-29 12:12:12
使用范例如下:

日期和时间模式

结果

yyyy.MM.dd G 'at' HH:mm:ss z

2001.07.04 AD at 12:08:56 PDT

EEE, MMM d, ''yy

Wed, Jul 4, '01

h:mm a

12:08 PM

hh 'o''clock' a, zzzz

12 o'clock PM, Pacific Daylight Time

K:mm a, z

0:08 PM, PDT

yyyyy.MMMMM.dd GGG hh:mm aaa

02001.July.04 AD 12:08 PM

EEE, d MMM yyyy HH:mm:ss Z

Wed, 4 Jul 2001 12:08:56 -0700

yyMMddHHmmssZ

010704120856-0700

yyyy-MM-dd'T'HH:mm:ss.SSSZ

2001-07-04T12:08:56.235-0700

详细定义可参考java.text.SimpleDataFormat。

formatFloat(Number float, String format)

Number类型数据格式化系统函数。

String formatFloat(Number data, String format)

将data数据以格式化的方式显示,format为格式化表达式,如:

var data = 3000.30;
var str = formatFloat(data, "#,##.## 元");

系统显示为: 30,00.30 元。

getViewModel([String namespace])

参考NameSpace

boolean parseBoolean(String value)

将各种类型的数据转换为boolean类型:

类型

规则

string

判断是否为字符串"true",区分大小写

boolean

直接判断是否为true

其他

判断是否为空

parseDate(String value)

可将字符串转换为日期对象:

var str = "2007-03-29 11:51:39";
var date = parseDate(str);

parseString(Any value)

可将对象转换为字符串:

var date = new Date();
var str = parseString(date);

fireDoradoEvent(DoradoElement element, String eventName, Array args)

代码触发dorado事件,事件申明:

any fireDoradoEvent(DoradoElement element, String eventName, Array args)

触发一个Dorado事件,此函数的返回值为事件的返回值.
Parameters
element - DoradoElement - 触发事件的对象
eventName - String - 事件名
args - Array - 事件参数数组
Returns:
Any

例如触发dataset的beforeChange事件:

fireDoradoEvent(dsEmployee, "beforeChange", [dsEmployee, dsEmployee.getCurrent(), dsEmployee.getField("salary"), 5000]);

ParameterSet

Dorado客户端的参数集合对象,被广泛的应用于Command,Dataset,ViewProperties中。
通常都是通过如下的方法存取ParameterSet对象:
范例1(获取dataset中信息并保存至command的parameters()中):

var ps = command.parameters();
ps.setValue("userId", dataset.parameters().getValue("userId"));

范例2(设置commannd中的empId参数为ANLIN,并执行远程调用,调用结束之后获得服务器端返回的docNo信息):

var ps = command.parameters();
ps.setValue("empId","ANLIN");
if (command.execute()){
var outPs = command.outParameters();
var returnValue = outPs.getValue("docNo");
}