历史版本28 :参数控件接口 返回文档
编辑时间: 内容长度:图片数:目录数: 修改原因:

目录:

1. 概述编辑

参数面板上添加控件实现参数查询时,当设计器中控件的配置项无法满足用户的需求时,用户可以使用  JavaScript  来开发功能,如修改控件样式、设置控件默认值、修改控件搜索逻辑、实现参数联动、实现参数查询等。

2. 接口编辑

2.1获取控件

对控件进行修改时,需要先获取到控件,那么如何使用 JavaScript 来获取到参数面板上的控件呢?

2.1.1 直接在参数面板中获取

直接在参数面板中使用 JavaScript 并获取控件,那么就可以直接使用:

this.options.form.getWidgetByName("widgetname")

注:如果是获取当前控件可以直接使用 this 替代。

2.1.2 在 Web 集成页面中获取

在web页面中获取 FineReport 报表里面的参数界面,那么就需要使用:

document.getElementById('reportFrame').contentWindow.contentPane.parameterEl.getWidgetByName('widgetname')

注:其中 reportFrame 是 Web 页面中嵌入 FineReport 报表的 iframe

2.1.3 在报表主体(单元格)获取

在报表主体即单元格中获取参数面板的控件需要使用:

contentPane.parameterEl.getWidgetByName("widgetname")

2.2 控件方法列表

获取到控件之后,需要对该控件进行再操作,可以获取其控件值,赋值,设置是否可见等等方法,如下列表:

注:其中 Widget 为获取到的控件。

方法说明
Widget.getValue()获取控件实际值
Widget.getText()获取控件的显示值
Widget.setValue()

给参数控件赋值,不建议给填报控件赋实际值

注:如果用 setValue() 给下拉树赋值,需要添加一个 false 参数,即 setValue(value,false);value 为需要赋给下拉树的值。

Widget.setText()给参数控件赋显示值
Widget.reset()清空数据
Widget.isVisible(boolean)返回控件是否可见,返回 true 可见,false 不可见
Widget.setVisible(boolean)设置控件是否可见,参数为 true 可见,false 不可见
Widget.setEnable(boolean)设置控件是否可用,参数为 true 可用,false 不可用
Widget.isEnabled(boolean)返回控件是否可用,返回 true 可用,false 不可用
Widget.fireEvent("事件名称")设置控件触发指定名字的事件
Widget.options.allowBlank=false设置控件是否可为空,true 可为空,false 不可为空