billClosedCallBack事件

1 事件介绍

插件可以在此事件，接收单据界面返回的值，进行后续处理；

也可以与双击、超链接等事件处理配合，打开自定义界面，接收自定义界面的返回值。

2 事件触发时机

列表打开的单据界面关闭并返回到列表时，触发此事件；

特别说明：

列表界面的billClosedCallBack事件，与closedCallBack事件的区别：

列表打开的单据界面关闭时，如果设置了回调属性，会先后触发列表插件的billClosedCallBack、closeCallBack两个事件；

在billClosedCallBack事件，系统会自动把单据界面上的单据内码，传递给事件；

而在closeCallBack事件，只能收到单据界面主动返回给列表界面的任意数据。

3 代码模板

package   kd.bos.plugin.sample.bill.list.template;
 
import   kd.bos.list.events.BillClosedCallBackEvent;
import   kd.bos.list.plugin.AbstractListPlugin;
 
public class BillClosedCallBack extends AbstractListPlugin {
 
    @Override
    public void billClosedCallBack(BillClosedCallBackEvent   e) {
         // TODO 在此添加业务逻辑
    }
}

4 参数说明

public class BillClosedCallBackEvent extends EventObject

• public Object getSource()：事件源，单据列表控件BillList；

• public Object getPkId()： 获取单据内码；

• public CloseCallBack getCloseCallBack()：回调参数，据此了解回调源头。

5 应用示例

5.1 案例说明

1. 单据列表上，单据编号、文本1两列，均显示为超链接；

2. 点击文本1，打开物料新增界面；

3. 比较billClosedCallBack、closedCallBack两个事件的事件参数值。

5.2 实现方案

1. 捕获billListHyperLinkClick事件，显示物料新增界面，并指定回调参数；

2. 捕获billClosedCallBack，接收事件参数pkid，提示出来；

3. 捕获closedCallBack，接收事件参数returndata，提示出来。

5.3 实例代码

package   kd.bos.plugin.sample.bill.list.bizcase;
 
import   kd.bos.bill.BillShowParameter;
import   kd.bos.bill.OperationStatus;
import   kd.bos.dataentity.utils.StringUtils;
import   kd.bos.form.CloseCallBack;
import   kd.bos.form.ShowType;
import   kd.bos.form.events.ClosedCallBackEvent;
import   kd.bos.form.events.HyperLinkClickArgs;
import   kd.bos.list.events.BillClosedCallBackEvent;
import   kd.bos.list.plugin.AbstractListPlugin;
 
public class BillClosedCallBackSample extends AbstractListPlugin {
 
    private final static String KEY_TEXTFIELD1 = "textfield1";
 
    /**
     * 用户点击超链接单元格时，触发此事件
     */
    @Override
    public void billListHyperLinkClick(HyperLinkClickArgs args) {
         if (StringUtils.equals(KEY_TEXTFIELD1,    args.getHyperLinkClickEvent().getFieldName())){
             // 当前点击的是文本1
            
             // 取消系统自动打开本单的处理
             args.setCancel(true);
            
             // 打开物料新增界面
             B