帆软FineReport——获取控件及控件方法

最新推荐文章于 2026-02-28 10:09:07 发布

原创最新推荐文章于 2026-02-28 10:09:07 发布 · 1.3w 阅读

28 ·

本内容遵循CC 4.0 BY-SA版权协议

帆软专栏收录该内容

14 篇文章

订阅专栏

本文介绍了帆软FineReport中控件的使用方法，包括setValue()与setCellValue()的区别，如何设置和获取单元格值，以及各种特定场景下的控件交互，如参数界面控件获取、刷新事件和按钮操作等。

1，控件

方法名	方法	说明
取值	Widget.getValue()	获取控件值
赋值	Widget.setValue()	给参数赋值
重置	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(“控件事件”)	通过js获取控件的某个事件

注：
⑴，Widget.setValue()该方法是给控件赋值，但是不建议在填报页面用该方法给控件赋值，因为这是给控件赋值，并不是单元格，在填报的时候如果使用该方法赋值，每次给控件赋值完成之后，将值传给单元格之前，会被清空，最后单元格的值还是为空，所以在填报页面建议使用setCellValue()给控件赋值。
⑵，若js脚本在当前控件的事件中，可以不用获取当前控件，直接使用this，如this.getValue();

2，设置单元格的值(填报预览)：

//contentPane.setCellValue(1,0,"abc");
contentPane.curLGP.setCellValue(1, 0, "abc")

3，获取单元格的值（填报预览，参数面板和报表控件都可以这样写）：

//contentPane.getCellValue(1,0);
contentPane.curLGP.getCellValue(1, 0)
var text=contentPane.curLGP.getCellValue("D2");//获取文本框控件所在单元格的值 
contentPane.getCellValue(sheet号,列号,行号);  //sheet号行号列号是从0开始
contentPane.curLGP.getCellValue(列号,行号);  
contentPane.curLGP.getCellValue(单元格);

4，当前控件值：

this.getValue();

5，参数界面获取参数界面控件：

var Widget = this.options.form.getWidgetByName("WidgetName"); //控件名

6，获取父模板：

var form = window.parent.form;

7，获取当前单元格行列号：

var row =contentPane.curLGP.getTDRow(td);   
var col =contentPane.curLGP.getTDCol(td);

8，获取工具栏的控件：

var toolbar = contentPane.toolbar;

var items = toolbar.options.items;

var customButton=items[2];//JQUERY取我们的工具栏上的按钮.items[2]代表的是第三个。

9，刷新事件（添加按钮点击事件）：

location.reload();

10，删除按钮弹出提示框、校验，2秒后提交入库

if(FR.Msg.confirm("警告","确认删除"))
{
    setTimeout(function(){
        _g('${sessionID}').writeReport(); 
        },2000);
        return true;
}
else
{
    return false;
}

11，单元格面板，添加保存入库按钮，成功之后刷新父页面并退出：

if(fr_submitinfo.success)
{
    FR.Msg.toast('保存成功');
    setTimeout(function() { 
                 window.parent._g().parameterCommit(); 
                }, 1000);//子页面调用父页面的查询
    setTimeout(function() { 
                 parent.FR.closeDialog(); 
                }, 2000);//关闭子窗口
}
else
{
    FR.Msg.toast('保存失败');
}