Dataset客户端事件使用详解

Dataset客户端事件使用详解

请参考《Dorado5用户指南》的5.15主要JS事件。

Dataset Client端的事件中，比较容易明白和使用的有beforeInsert、afterInsert、beforeDelete、afterDelete、beforePost、afterPost、beforeCancel、afterCancel、beforeSelectionChange、afterSelectionChange、beforeFlushData、afterFlushData、onCreate、onActive，这些事件在client-api中说明得比较清楚。

我们来重点看一下Dataset除了上面提到的Client端事件之外的事件：

a)    beforeScroll、afterScroll

请参考《Dorado5用户指南》的5.15主要JS事件。

这里想说明一点的是，通过afterScroll事件还可以做到对控件的状态等的控制。比如说在afterScroll事件里控制DataTable的某一行或者某一单元格的只读等等状态。

下面的afterScroll事件代码是控制某一行只读还是可编辑：

var record = dataset.getCurrent();

if(record){

    var SEX = record.getValue("SEX");

    if(SEX){

       if(SEX=="false"){

           dataset.setReadOnly(false);

       }else{

           dataset.setReadOnly(true);

       }

    }else{

       dataset.setReadOnly(true);

    }

}else{

    dataset.setReadOnly(true);

}

 

把代码 中的dataset.setReadOnly换成dataset.getField(“name”). setReadOnly就可以控制某一单元格的可编辑性等等。

 

b)    beforeChange、afterChange

请参考《Dorado5用户指南》的5.15主要JS事件。

beforeChange大多数用来做Field的Validators，一般用来验证新值符合条件不。

afterChange一般是用来对某个值改变之后触发其它的事件。

c)     onGetValue、onSetValue

onGetValue是数据集中读取一个数值时触发，返回读到的数值。这个事件可以做一些字符的过滤或者经过处理的值返回。

onSetValue之前触发了beforeChange事件，之后触发了afterChange事件。这三个事件就各自分配了对新值的处理功能。beforeChange对新值做判断，onSetValue对新值在做处理，afterChange对因为新值触发其它事件。

这里要特别注意的是，要考虑一下这些事件里有没有一些代码可以会再触发本身的事件，比如说在beforeChange或者onSetValue或者afterChange（字段field1）中又执行了dataset.setValue(“field1”,value);这样的话就形成了死循环。一般的解决办法是通过dataset的事件开关disableEvents、enableEvents来处理。

d)    onFilterRecord

当系统过滤记录集时触发，该事件的返回值为true表示当前处理的记录可见，否则该记录将被视为不可见。系统初始化的时候会对该事件执行一次。