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、 若JS脚本位于当前控件的事件中，可直接使用this调用方法，无需获取控件对象，例如调用this.getValue()即可。

8、 在Widget.fireEvent(事件名称)中，所填名称需参考控件事件章节中列出的具体事件名称。

9、 Widget.setValue() 方法用于为控件设置值，但在填报页面中不推荐使用该方法。原因是此方法仅对控件本身赋值，并未直接作用于单元格。在填报过程中，即使通过该方法成功为控件赋值，在值传递至对应单元格前，该值会被清除，导致最终单元格内容仍为空。因此，为确保数据正确提交，在填报页面应优先使用 setCellValue() 方法进行赋值操作，以保证值能准确写入单元格并被正常保存和读取。