历史版本10 :参数控件接口 返回文档
编辑时间:
内容长度:图片数:目录数:
修改原因:
1. 描述编辑
在对参数面板进行js二次开发时,比如说对参数面板上的控件进行再操作,就需要获取到参数面板上的控件,那么如何使用js来获取到参数面板上的控件呢?
2. 获取控件编辑
2.1 直接在参数面板中获取
直接在参数面板中使用js并获取控件,那么就可以直接使用:
this.options.form.getWidgetByName("widgetname")
注:如果是获取当前控件可以直接使用this替代。
2.2 在web集成页面中获取
在web页面中获取FineReport报表里面的参数界面,那么就需要使用:
document.getElementById('reportFrame').contentWindow.contentPane.parameterEl.getWidgetByName('widgetname')
注:其中reportFrame是web页面中嵌入FineReport报表的iframe
3. 控件方法列表编辑
获取到控件之后,需要对该控件进行再操作,可以获取其控件值,赋值,设置是否可见等等方法,如下列表:
方法名 | 方法 | 说明 |
取实际值 | Widget.getValue() | 获取控件实际值 |
取显示值 | Widget.getText() | 获取控件的显示值 |
赋实际值 | Widget.setValue() | 给参数控件赋值,不建议给填报控件赋实际值 |
赋显示值 | Widget.setText() | 给参数控件赋显示值 |
重置 | Widget.reset() | 清空数据 |
可见 | Widget.visible() | 设置控件可见 |
不可见 | Widget.invisible() | 设置控件不可见 |
是否可见 | Widget.isVisible() | 返回控件是否可见,返回true可见,false不可见 |
设置可见 | Widget.setVisible(boolean) | 设置控件是否可见,参数为true可见,false不可见 |
设置可用 | Widget.setEnable(boolean) | 设置控件是否可用,参数为true可用,false不可用 |
是否可用 | Widget.isEnabled() | 返回控件是否可用,返回true可用,false不可用 |
调用控件事件 | Widget.fireEvent("事件名称") | 设置控件触发指定名字的事件 |
是否可以为空 | Widget.options.allowBlank=false | 设置控件是否可为空,true可为空,false不可为空 |
注:其中Widget为获取到的控件。
另:如果用setValue()给下拉树赋值,需要添加一个false参数,即setValue(value,false);value为需要赋给下拉树的值
4. 示例链接编辑
参数控件取实际值和赋值请查看参数控件赋值;
设置控件是否可见、可用请查看根据条件控制参数控件是否显示(可用);
参数控件重置请查看清空条件。
索引: