registerListener事件

1 事件介绍

在此事件，可以侦听各个控件的插件事件。

说明：控件必须在registerListener方法中进行注册之后才会执行控件的事件。比如页面中有一个按钮控件，需要先在registerListener方法中添加该按钮控件，点击按钮时才会执行click、beforeClick等方法，否则不会执行，按钮控件相关事件请参考按钮控件 (kingdee.com)。其他控件同理。

2 事件触发时机

用户与界面上的控件进行交互时，即会触发此事件。

3 代码模板

package   kd.bos.plugin.sample.dynamicform.pcform.form.template;
 
import   java.util.EventObject;
 
import   kd.bos.form.plugin.AbstractFormPlugin;
 
public class RegisterListener extends AbstractFormPlugin {
 
    @Override
    public void registerListener(EventObject e) {
         // TODO 侦听控件的插件事件
    }
}

4 参数说明 

EventObject e: 事件参数对象，含有事件源

• Object getSource(): 事件源，表单编程模型IFormView对象。

5 应用示例

5.1 案例说明

1. 响应主菜单上自定义的菜单点击事件；

2. 响应自定义按钮点击事件；

3. 响应单据体行点击事件；

4. 响应树形控件节点点击事件。

5.2 实现方案

1. 插件实现控件的插件事件接口，实现事件的处理方法；

2. 捕获表单 registerListener事件，侦听控件的插件事件，传入实现了事件接口的插件实例；

3. 略过事件处理的详细逻辑。

5.3 实例代码

package   kd.bos.plugin.sample.dynamicform.pcform.form.bizcase;
 
import java.util.EventObject;
 
import   kd.bos.dataentity.utils.StringUtils;
import   kd.bos.form.control.Button;
import   kd.bos.form.control.Control;
import   kd.bos.form.control.EntryGrid;
import   kd.bos.form.control.Toolbar;
import   kd.bos.form.control.TreeView;
import   kd.bos.form.control.events.ClickListener;
import   kd.bos.form.control.events.ItemClickEvent;
import   kd.bos.form.control.events.ItemClickListener;
import   kd.bos.form.control.events.RowClickEvent;
import   kd.bos.form.control.events.RowClickEventListener;
import   kd.bos.form.control.events.TreeNodeClickListener;
import   kd.bos.form.control.events.TreeNodeEvent;
import   kd.bos.form.plugin.AbstractFormPlugin;
 
public class RegisterListenerSample extends AbstractFormPlugin implements ItemClickListener, ClickListener,   RowClickEventListener, TreeNodeClickListener {
   
    private final static String KEY_MBAR = "tbmain";
    private final static String KEY_BARITEM1 = "baritem1";
    private final static String KEY_BUTTON1 = "buttonap1";
    private final static String KEY_ENTRYENTITY = "entryentity";
    private final static String KEY_TREEVIEW1 = "treeviewap1";
   
    @Override
    public void registerListener(EventObject e) {
         super.registerListener(e);
        
         // 侦听各控件的插件事件，传入实现了事件接口的插件实例
        
         // 主菜单按钮点击