FineReport控件引用与方法

控件具备多种操作方法，如设置可见性、启用状态等。在调用这些方法前，必须先获取对应控件对象。自6.5.5版本起，在参数界面、填报界面或表单界面（op=form）中均可实现控件的获取与方法调用。接下来以复杂报表工具FineReport为例，简要说明其具体应用方式和操作流程。

1、 获取组件

2、 在参数界面和表单界面（op=form）中，获取控件的方法一致：先取得表单对象，再根据控件名称获取具体控件，操作方式如下所示。

3、 7.0版本对填报界面获取控件的方式进行了改进，相较6.5.5版本更加简便，只需通过contentPane直接调用控件名称即可完成获取，操作更高效直观。

4、 控件常用操作

5、 通过上述方法可获取控件，如将控件变量命名为Widget，则可通过调用Widget.getValue()来使用该控件的方法。

6、 假设控件变量为Widget，以下为其方法列表。

7、 如果JavaScript脚本位于当前控件的事件中，可直接使用this调用方法，无需额外获取控件对象，例如调用this.getValue()即可。

8、 在Widget.fireEvent(事件名称)中，具体参数可参考控件事件部分列出的事件名称。

9、 Widget.setValue() 方法用于为控件设置值，但在填报页面中不推荐使用。因为该方法仅对控件本身赋值，并未直接作用于单元格。在填报过程中，即使通过该方法成功为控件赋值，在值传递给对应单元格之前，该值可能已被清空，最终导致单元格仍为空。因此，为确保数据正确提交，在填报页面应优先使用 setCellValue() 方法进行赋值，以保证值能准确写入单元格并正常保存，避免因赋值方式不当造成数据丢失或无法提交的问题。