容器控件基类

栏目：云苍穹知识作者：金蝶来源：金蝶云社区发布：2024-09-23浏览：1

容器控件基类

1 插件介绍

系统封装了一个容器控件基类，所有容器控件，都从此派生，继承其方法、插件事件。

容器控件基类名Container，在bos-form-core-1.0.jar，定义如下：

package kd.bos.form.container;
public class Container extends Control implements ISuportClick {

插件可以使用如下代码，获取容器控件实例：

Container container = this.getView().getControl(KEY_CONTAINER1);

说明：常量KEY_CONTAINER1是容器控件的标识。

2 控件方法

容器控件基类Container，除了控件基类Control提供的方法，还增加了如下公共方法：

方法	说明
getItems	获取子控件集合，不包括嵌套的子控件
getOperationKey	获取绑定的操作标识
setOperationKey	设置绑定的操作标识，点击时，自动执行此操作
setBackgroundImg	设置背景图片URL地址
addControls	动态添加子控件
insertControls	动态插入子控件
setCollapse	折叠、展开容器控件
addClickListener	侦听容器控件的点击事件插件必须实现点击事件接口ClickListener 部分控件未支持
addItemClickListener	暂未实现
click	用户点击前端控件时，系统自动调用此方法，触发插件点击事件内部方法，插件勿调用部分控件未支持

3 插件事件

容器控件基类Container，默认提供如下插件事件：

事件方法	事件所在接口	触发时机
beforeClick	ClickListener	用户点击前端控件时，触发此事件
click	ClickListener	用户点击前端控件时，触发此事件如果插件在beforeClick事件中，取消了后续处理，则不触发此事件