历史版本16 :参数控件接口 返回文档
编辑时间:
内容长度:图片数:目录数:
修改原因:
1. 描述编辑
在对参数面板进行 JavaScript 二次开发时，比如说对参数面板上的控件进行再操作，就需要获取到参数面板上的控件，那么如何使用 JavaScript 来获取到参数面板上的控件呢？
2. 获取控件编辑
2.1 直接在参数面板中获取
直接在参数面板中使用 JavaScript 并获取控件，那么就可以直接使用：
this.options.form.getWidgetByName("widgetname")注：如果是获取当前控件可以直接使用 this 替代。
2.2 在 Web 集成页面中获取
在web页面中获取 FineReport 报表里面的参数界面，那么就需要使用：
document.getElementById('reportFrame').contentWindow.contentPane.parameterEl.getWidgetByName('widgetname')注：其中 reportFrame 是 Web 页面中嵌入 FineReport 报表的 iframe
2.3 在报表主体(单元格)获取
在报表主体即单元格中获取参数面板的控件需要使用：
contentPane.parameterEl.getWidgetByName("widgetname") 3. 控件方法列表编辑
获取到控件之后，需要对该控件进行再操作，可以获取其控件值，赋值，设置是否可见等等方法，如下列表：
| 方法 | 说明 |
|---|---|
| Widget.getValue() | 获取控件实际值 |
| Widget.getText() | 获取控件的显示值 |
| Widget.setValue() | 给参数控件赋值，不建议给填报控件赋实际值 |
| Widget.setText() | 给参数控件赋显示值 |
| Widget.reset() | 清空数据 |
| Widgeti.setVisible(boolean) | 设置控件是否可见，参数为 true 可见，false 不可见 |
| 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 不可为空 |
注：其中 Widget 为获取到的控件。
另：如果用 setValue() 给下拉树赋值，需要添加一个 false 参数，即 setValue(value,false);value 为需要赋给下拉树的值