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()方法进行赋值操作，以实现控件与单元格之间的准确数据同步，保障填报功能的正常运行和数据完整性。