学习目标

掌握不同页面的界面参数如何构造

内容简介

通过前面的课程《弹窗实现及父子页面传参》学习，我们知道了通过配置操作以及showform这两种方式可以实现弹出一个界面，其中给showform传不同的参数即可打开不同的界面，接下来将介绍不同类型的界面参数如何构造。

1. 弹出动态表单-FormShowParameter

FormShowParameter是最基础的界面参数对象，其他界面参数对象都是继承于FormShowParameter生成的，然后增加了新属性。

//创建弹出页面对象，FormShowParameter表示弹出页面为动态表单
FormShowParameter showParameter = new FormShowParameter();
//设置弹出哪个动态表单
showParameter.setFormId("kded_suppliesapplynew");
//设置弹出页面标题
showParameter.setCaption("物品新增申请界面");
//设置子页面关闭回调参数，回调标识为XXX
showParameter.setCloseCallBack(new CloseCallBack(this,"XXX"));
//设置弹出页面的打开方式，支持模态，新标签等
showParameter.getOpenStyle().setShowType(ShowType.Modal);
//设置弹出页面的大小，高600宽800
StyleCss inlineStyleCss = new StyleCss();
inlineStyleCss.setHeight("600");
inlineStyleCss.setWidth("800");
showParameter.getOpenStyle().setInlineStyleCss(inlineStyleCss);
//弹出动态表单页面
this.getView().showForm(showParameter);
备注：其他弹出界面的设置页面关闭回调参数、设置弹出页面的大小样式都是一样的代码，后面可能不会重复写。

2.弹出单据界面-BillShowParameter

BillShowParameter继承于FormShowParameter，在FormShowParameter基础上增加pkId（单据id）、billStatus（单据状态）、billTypeId（单据类型）等参数。

//创建弹出单据页面对象，BillShowParameter 表示弹出页面为单据页面
BillShowParameter billShowParameter = new BillShowParameter();
//设置弹出的单据标识
billShowParameter.setFormId("kded_supsinventorybill");
//设置弹出单据页面的标题
billShowParameter.setCaption("办公用品库存单列表界面");
//设置弹出单据的pk，如没有这行，则打开的是单据新增界面
billShowParameter.setPkId(KEY_PKID);
//设置弹出单据页面的打开方式
billShowParameter.getOpenStyle().setShowType(ShowType.Modal);
//设置弹出单据页面的大小，高600宽800
StyleCss inlineStyleCss = new StyleCss();
inlineStyleCss.setHeight("600");
inlineStyleCss.setWidth("800");
billShowParameter.getOpenStyle().setInlineStyleCss(inlineStyleCss);
//弹出单据页面
this.getView().showForm(billShowParameter);

3.弹出列表界面-ListShowParameter

ListShowParameter继承于FormShowParameter，在FormShowParameter基础上增加了BillFormId（单据id）、multiSelect（允许多选）、billTypeId（单据类型）、listFilterParameter（列表过滤条件）等参数。

//创建弹出列表界面对象，ListShowParameter 表示弹出页面为列表界面
ListShowParameter listShowParameter = new ListShowParameter();
//设置FormId，列表的FormId固定为"bos_list"
listShowParameter.setFormId("bos_list");
//设置BillFormId，为列表所对应单据的标识
listShowParameter.setBillFormId("kded_supsinventorybill");
//设置弹出页面标题
listShowParameter.setCaption("办公用品库存单列表界面");
//设置弹出页面的打开方式
listShowParameter.getOpenStyle().setShowType(ShowType.Modal);
//设置为不能多选，如果为true则表示可以多选
listShowParameter.setMultiSelect(false);
//设置子页面关闭回调参数，回调标识为XXX
listShowParameter.setCloseCallBack(new CloseCallBack(this, "XXX"));
//弹出列表界面
this.getView().showForm(listShowParameter);

4. 弹出F7选择界面

F7选择界面也是用的ListShowParameter ，只是formid需要改成F7列表表单模板编码，通用基础资料的F7列表表单模板是bos_listf7，分组基础资料和树形基础资料的F7列表表单模板是bos_templatetreelistf7。

//创建弹出列表界面对象，ListShowParameter 表示弹出页面为列表界面
ListShowParameter listShowParameter = new ListShowParameter();
//设置F7列表表单模板
listShowParameter.setFormId("bos_templatetreelistf7");
//设置BillFormId为基础资料的标识
listShowParameter.setBillFormId("kded_supplies");
//设置弹出页面标题
listShowParameter.setCaption("物品F7选择界面");
//设置弹出页面的打开方式
listShowParameter.getOpenStyle().setShowType(ShowType.Modal);
//设置打开页面的大小
StyleCss inlineStyleCss = new StyleCss();
inlineStyleCss.setHeight("580");
inlineStyleCss.setWidth("960");
listShowParameter.getOpenStyle().setInlineStyleCss(inlineStyleCss);
//设置为不能多选，如果为true则表示可以多选
listShowParameter.setMultiSelect(true);
//LookUp必须为true，该界面才是可选界面
listShowParameter.setLookUp(true);
//是否只显示审核的数据
listShowParameter.setShowApproved(true);
//是否只显示只启用的数据
listShowParameter.setShowUsed(true);
//设置子页面关闭回调参数，回调标识为XXX setControlKey用来设置f7选择的数据返回给哪个字段
CloseCallBack closeCallBack =new CloseCallBack(this, "kded_addf7");
closeCallBack.setControlKey("kded_supplies");
listShowParameter.setCloseCallBack(closeCallBack);
//弹出F7选择界面
this.getView().showForm(listShowParameter);

5. 弹出移动表单界面-MobileFormShowParameter

//创建弹出页面对象，MobileFormShowParameter表示弹出页面为移动动态表单
MobileFormShowParameter mobShowParameter = new MobileFormShowParameter();
//设置弹出移动动态表单的编码
mobShowParameter .setFormId("kded_addnewwupinmob");
//设置子页面关闭回调参数，回调标识为XXX
mobShowParameter.setCloseCallBack(new CloseCallBack(this, "kded_addmobform"));
//设置弹出页面打开方式，支持模态，新标签等
mobShowParameter.getOpenStyle().setShowType(ShowType.Floating);
//弹出移动表单页面
this.getView().showForm(mobShowParameter );

6. 弹出移动单据界面-MobileBillShowParameter

//创建弹出移动单据界面对象，MobileBillShowParameter 表示弹出页面为移动单据界面
MobileBillShowParameter mobBillShowParameter = new MobileBillShowParameter ();
//设置FormId
 mobBillShowParameter.setFormId("单据标识");
//设置打开哪张单据
mobBillShowParameter.setPkId("单据id");
//设置弹出页面的打开方式
mobBillShowParameter.getOpenStyle().setShowType(ShowType.Floating);
//设置子页面关闭回调对象，回调本插件，标识为XXX
mobBillShowParameter.setCloseCallBack(new CloseCallBack(this, "xxx"));
//弹出界面
this.getView().showForm(mobBillShowParameter);

7. 弹出移动列表界面-MobileListShowParameter

//创建弹出移动列表界面对象，MobileListShowParameter 表示弹出页面为移动列表界面
MobileListShowParameter mobBillListShowParameter = new MobileListShowParameter();
//设置FormId，移动列表的FormId固定为"bos_moblist"
mobBillListShowParameter .setFormId("bos_moblist");
//设置BillFormId，为列表所对应单据的标识
String billformid = "kded_officesuppliesbill";
mobBillListShowParameter .setBillFormId(billformid);
//设置弹出页面的打开方式
mobBillListShowParameter .getOpenStyle().setShowType(ShowType.Floating);
//设置子页面关闭回调对象，回调本插件，标识为XXX
mobBillListShowParameter .setCloseCallBack(new CloseCallBack(this, "xxx"));
//弹出列表界面
this.getView().showForm(mobBillListShowParameter);

8.常用的ShowType

（1）浏览器新页签

showParameter.getOpenStyle().setShowType(ShowType.Window);

（2）模态显示

showParameter.getOpenStyle().setShowType(ShowType.Modal);

（3）应用内新页签

showParameter.getOpenStyle().setShowType(ShowType.MainNewTabPage);

（4）应用外新页签

showParameter.getOpenStyle().setShowType(ShowType.NewTabPage);
showParameter.getOpenStyle().setTargetKey("tabap");//PC主页面页签容器的标识

（5）在某个容器内打开，比如在页签控件里的某个页签内打开

showParameter.getOpenStyle().setShowType(ShowType.InContainer);
showParameter.getOpenStyle().setTargetKey("tabpageap_task");//某个页签的标识

（5）浮动显示，用于打开移动页面时使用

showParameter.getOpenStyle().setShowType(ShowType.Floating)

界面参数构造

恭喜您！