动态表单插件-视图模型
1 插件介绍
动态表单界面插件，可以通过系统封装的表单视图模型，访问界面信息，对界面进行控制。
2 插件接口与实现类
动态表单的视图模型接口为IFormView，定义了各种界面控制方法：
package kd.bos.form;
public interface IFormView {
动态表单的视图模型实现类为FormView，实现了接口IFormView：
package kd.bos.mvc.form;
public class FormView extends AbstractFormView {package kd.bos.form;
public abstract class AbstractFormView implements IFormView {
插件可以使用如下代码，获取动态表单界面视图模型实例：
IFormView view = this.getView();
3 功能方法与使用
动态表单界面视图模型IFormView接口，定义了很多方法，下表列出插件需要用到的部分方法：
方法 | 说明 |
getPageId() | 表单被加载时，会随机生成一个界面PageId； 一个表单被两个用户同时打开时，生成的界面PageId不同； 可以根据返回的PageId，获取到表单视图模型实例 |
getView(String pageId) | 指定PageId，获取对应的表单视图模型； 可以据此对目标表单进行控制 |
getEntityId() | 获取表单对应的主实体标识 |
getModel() | 获取表单数据模型实例 |
sendFormAction(IFormView view) | 把目标表单的控制指令发送给前端； 插件调用了其他表单的控制方法后，必须调用本方法，把控制指令，发送给前端 |
getParentView() | 获取父表单视图模型实例 |
getMainView() | 获取主界面视图模型实例 |
| updateView() | 把数据模型中的数据，发送到前端界面； |
updateView(String key) | 可以指定只刷新单个单据体、单个控件，如：updateView("entryentity"） |
getControl(String key) | 获取表单的控件实例，如 getControl("textfiled"） |
getRootControl() | 获取表单实例 |
getService(Class<?> clazz) | 获取服务实例 |
invokeOperation(String operationKey) | 执行具体操作，如 invokeOperation("refresh") |
activate() | 激活表单 |
close() | 关闭表单 |
setEnable(Boolean value, String... ctlKeys) | 设置控件可用性，如设置按钮不可点击 setEnable(false, "btnok") |
setVisible(Boolean value, String... ctlKeys) | 设置控件可见性，如设置按钮不可见 setVisible(false, "btnok") |
showForm(FormShowParameter paramerter) | 传入表单显示参数，打开一个新的表单，作为本表单的子表单； 该表单关闭时，会触发本表单插件closedCallBack事件； 请参阅4.1应用实例 |
getFormShowParameter() | 获取表单显示参数 |
cacheFormShowParameter() | 修改表单显示参数对象属性值之后，调用本方法把参数更新到缓存 |
returnDataToParent(Object value) | 设置返回到父表单的返回值 |
openUrl(String url) | 打开一个新窗口链接到指定的URL |
showUpload(UploadOption option, String callbackButtonKey) | 显示一个文件上传界面； 文件上传完毕，确认返回时，会触发插件afterUpload事件 |
showMessage(String msg, String titile) | 单据内悬浮消息框，默认没有按钮，自动消失 |
showErrMessage(String msg, String titile) | 显示错误消息 |
showOperationResult(OperationResult, String operateName) | 显示操作结果 |
showConfirm(String msg, MessageBoxOptions options) | 显示确认消息； 用户确认完毕，会触发confirmCallBack事件； 请参阅confirmCallBack事件说明及实例 |
showSuccessNotification(String msg) | 单据内成功悬浮消息框，默认2秒自动消失 消息内容,不能超过50字,超过部分用三个点代替 |
showErrorNotification(String msg) | 单据内失败悬浮消息框，需要手动关闭 消息内容,不能超过50字,超过部分用三个点代替 |
showTipNotification(String msg) | 单据内提示类别悬浮消息框，提示类会显示按钮，需要手动关闭 消息内容,不能超过50 |
动态表单插件-视图模型
声明：除非特别标注，否则均为本站原创文章，转载时请以链接形式注明文章出处。如若本站内容侵犯了原著者的合法权益，可联系本站删除。
