反馈已提交

网络繁忙

报表参数界面API

  • 文档创建者:lu123
  • 历史版本:44
  • 最近更新:yzmAANMS2901908 于 2023-02-01
  • 1. 概述

    1.1 应用场景

    在设计器中可以通过对参数界面的设计来控制参数的显示形式,如参数界面的布局、背景、显示方式等。那如何在程序中控制参数的相关属性呢?,如下图所示,修改参数面板的背景为绿色,并且居中显示。

    222

    1.2 实现原理

    FineReport 中通过 ReportParameterAttr 类来实现。以下具体介绍该类的使用方法。

    1)读取报表参数属性 ReportParameterAttr

    若已经读取了一个模板并将其保存为 WorkBook 对象,如下

    WorkBook workbook = (WorkBook) TemplateWorkBookIO.readTemplateWorkBook("//doc//Primary//Parameter//Parameter.cpt");

    就可以读取该 WorkBook 对象的参数属性,从而控制报表参数属性。

    获取 WorkBook 工作薄的参数属性 ReportParameterAttr

    ReportParameterAttr paraAttr = workbook.getReportParameterAttr();

    2)调整参数界面的布局

    /* 参数界面的布局 
     * 0 : 靠左 
     * 1 :居中 
     * 2 : 靠右 
     */  
    paraAttr.setAlign(1);

    3)设置参数背景

    /* 
     * 设置参数界面背景 
     * ColorBackground :颜色背景 
     * GradientBackground :渐变色背景 
     * ImageBackground :图片背景 
     * PatternBackground :图案背景 
     * TextureBackground :纹理背景 
     */ 
    Background background = ColorBackground.getInstance(new Color(0, 255, 255));
    paraAttr.setBackground(background);

    4)重新设置参数属性

    改变了一系列参数属性后,需要将改变后的 ReportParameterAttr 重新添加至 WorkBook 中

    //重新设置参数属性,导出最终结果 workbook.setReportParameterAttr(paraAttr);

    2. 示例

    以下示例读取内置模板 Parameter.cpt 修改参数面板样式后,将结果导出成 cpt 文件。

    2.1 准备编译环境

    编译程序前,需先创建一个 Java 工程环境,并且需要一个 Java 编辑器,如 Eclipse 或 idea 。

    在编辑器工程中导入 FineReport 工程 JAR 包。包括用户自己报表工程

    %FR_HOME%/lib下的所有的包,

    %FR_HOME%/server/lib 下的所有包,

    %FR_HOME%/webapps/webroot/WEB-INF/lib下的所有包,

    还要引入 JDK 下的 tools.jar。详细操作可参考:编译Java程序 

    2.2 编写 Java 程序

    在编辑器中编写 Java 程序 SetParameterWindow.java,即读取内置模板 Parameter.cpt 后修改参数面板样式后,将结果导出成 cpt 文件。完整代码可参见:

    注:用户使用时,注意将示例代码中的工程路径、模板名称和导出路径替换为用户自己工程下的。

    https://code.fanruan.com/demo/example/src/release/10.0/src/main/java/com/fr/io/SetParameterWindow.java

    2.3 编译 Java 文件

    Java 程序编写完成后,在编译器中编译 SetParameterWindow.java ,编译通过后,就会在代码中导出路径的文件夹下生成修改过的新文件 newParameter.cpt,这样就实现了读取模板后修改参数面板属性后导出。

    打开生成的模板,在浏览器端预览模板,就会看到参数界面背景色为绿色且居中显示。如下图所示:

    222

    附件列表


    主题: 二次开发
    • 有帮助
    • 没帮助
    • 只是浏览
    中文(简体)

    鼠标选中内容,快速反馈问题

    鼠标选中存在疑惑的内容,即可快速反馈问题,我们将会跟进处理。

    不再提示

    10s后关闭

    联系我们
    在线支持
    获取专业技术支持,快速帮助您解决问题
    工作日9:00-12:00,13:30-17:30在线
    页面反馈
    针对当前网页的建议、问题反馈
    售前咨询
    采购需求/获取报价/预约演示
    或拨打: 400-811-8890 转1
    qr
    热线电话
    咨询/故障救援热线:400-811-8890转2
    总裁办24H投诉:17312781526
    提交页面反馈
    仅适用于当前网页的意见收集,帆软产品问题请在 问答板块提问前往服务平台 获取技术支持