最新历史版本
:自定义按钮 返回文档
编辑时间:
内容长度:图片数:目录数:
修改原因:
1. 概述编辑
1.1 问题描述
FineReport 中内置的工具栏形式相对固定，不能够灵活地变更样式和位置。
用户希望可以自定义一套工具栏，通过 iframe 嵌入报表内容，将自定义按钮放置在报表页面之外。
并且实现在点击自定义按钮时，能够通过 JS 调用 FineReport 内置工具栏的方法，来对报表进行一些操作。如下图所示：
1.2 实现思路
如何实现通过自定义按钮来操作报表呢？
如果报表嵌入在 ID 为 reportFrame 的 iframe 中，可以通过下面格式的 JS 代码，直接调用 FineReport 内置工具栏中的方法：
document.getElementById('reportFrame').contentWindow.contentPane.方法名称();
2. contentPane下所有工具栏按钮事件及说明编辑
| 按钮名称 | 方法名称 | 说明 |
|---|---|---|
| 首页 | gotoFirstPage() | 跳转到第一页 |
| 末页 | gotoLastPage() | 跳转到最后一页 |
| 上一页 | gotoPreviousPage() | 跳转到上一页 |
| 下一页 | gotoNextPage() | 跳转到下一页 |
| 跳转到指定页 | gotoPage(num) | 跳转到指定 num 页 |
| 零客户端打印 | noClientPrint(popupMarginSetup, ieQuietPrint) | popupMarginSetup：是否弹出设置窗口，true 为弹出，false 为不弹出 ieQuietPrint： IE静默打印设置 true 为静默，false 为不静默 |
| 本地打印 | newNativePrint(popupDialog, serverURL) | popupDialog：是否弹出设置窗口，true 为弹出，false 为不弹出 serverURL：报表所在的服务器地址，例如 http://localhost:8080 |
| pdf导出 | exportReportToPDF() | pdf 导出 |
| word导出 | exportReportToWord() | word 导出 |
| excel导出 | exportReportToExcel('指定格式') | 参数为 page 时分页导出；simple 原样导出；sheet 分页分 sheet 导出 |
| 邮件 | emailReport() | 邮件发送 |
| 打印预览 | printPreview() | iframe 中的报表为分页预览或者数据分析时才可以用 |
| 提交 | writeReport() | 强制提交 |
| 校验 | verifyReport() | 数据校验，只有填报表才可以用 |
| 校验并提交 | verifyAndWriteReport() | 先对数据进行校验，校验成功则提交数据 |
| 插入行列 | appendReportRC(num) | 插入 num 行或列，只有填报表才可以用 |
| 删除行列 | deleteReportRC() | 删除行列，只有填报表才可以用 |
| 导入excel | importExcel() | 在线导入 Excel，只有填报表才可以用 |
| 页面设置 | pageSetup() | 只有数据分析才可以用 |