报表生成器FastReport .Net用户指南:关于脚本(上)

FastReport的报表生成器(无论VCL平台还是.NET平台),跨平台的多语言脚本引擎FastScript,桌面OLAP FastCube,如今都被世界各地的开发者所认可,这些名字被等价于“速度”、“可靠”和“品质”,在美国,欧洲和非洲不同国家均设有办事处。FastReports网站有10种不同语言的介绍,FastReports报表拥有40种语言的本地化的信息。

FastReport .Net是一款全功能的Windows Forms、ASP.NET和MVC报表分析解决方案,使用FastReport .NET可以创建独立于应用程序的.NET报表,同时FastReport .Net支持中文、英语等14种语言,可以让你的产品保证真正的国际性。

FastReport.NET官方版下载(qun:585577353)icon-default.png?t=N7T8https://www.evget.com/product/1861/download

一般信息

与其他报告生成器不同,FastReport 中的脚本只包含您编写的内容。在脚本中,您可以

  • 在主脚本类中添加变量、方法和属性;
  • 创建报告对象的事件处理程序;
  • 根据需要在脚本中添加新的类。类可以添加在 ReportScript 主类之前或之后。

您不能

  • 删除、重命名或更改 ReportScript 主类的可见性区域;
  • 重命名主类所在的命名空间。

运行报告时,会出现以下情况:

  • fastReport 会在脚本中添加变量列表,这些变量的名称与报告对象的名称相对应。这是在编译脚本之前完成的,这样就可以通过名称来引用报告对象;
  • 在脚本中添加表达式处理程序,处理报告中的所有表达式;
  • 如果脚本不为空,则编译脚本;
  • 初始化脚本类;
  • 运行报告。
事件处理程序

脚本主要用于创建对象的事件处理程序。要创建事件处理程序,请选择所需的对象。在 "Properties(属性)"窗口中按下 按钮,打开事件列表:

fastreport

选择需要的事件并双击。FastReport 会在报告代码中添加一个空的事件处理程序:

private void Text2_BeforePrint(object sender, EventArgs e) { }

“Report "对象也有事件。可以通过以下方法选择该对象:

  • 在 "Report Tree”窗口中选择 "Report";
  • 在 "Properties "窗口的下拉列表中选择 "Report"。

要删除事件处理程序,请在 "Properties "窗口中选择一个事件,选中文本并按下删除键:

fastreport

报告事件

为了最大限度地灵活控制报表,每个报表对象都有多个事件。例如,在与 "Data"带连接的处理程序中,可以过滤记录,即根据特定条件隐藏或显示带。

让我们考虑一下在报表生成过程中触发的事件。以一个简单的报表为例,该报表包含一个页面、一个 "Data "条带和条带上的两个 "Text "对象:

fastreport

在报告开始时,"Report "对象会触发 StartReport 事件。在报告页面形成之前,StartPage 事件会被触发。每个模板页面(不要与准备好的报告页面混淆!)都会触发一次该事件。在我们的例子中,无论准备好的报告有多少页,事件都会被触发一次,因为模板报告只有一页。

然后,开始打印 "Data" 带行。具体过程如下:

  • 触发 BeforePrint 带事件;
  • 打印带中所有对象的 BeforePrint 事件被触发;
  • 所有对象都填入数据;
  • 所有位于带状布局上的对象的 AfterData 事件被触发;
  • 触发 BeforeLayout 频带事件;
  • 将对象放置在带状区域上,计算带状区域的高度并拉伸带状区域(如果可以的话);
  • 触发 AfterLayout band 事件;
  • 如果带状物件无法放置在页面的空闲位置,则会形成一个新页面;
  • 在准备好的报告页面上显示条带及其所有对象;
  • 触发 AfterPrint 频带事件;
  • 触发所有条带对象的 AfterPrint 事件。
  • 只要数据源中有数据,就会打印数据带行。之后,在我们的例子中,报告的形成就结束了。一个页面的 FinishPage 事件被触发,最后--"报表 "对象的 FinishReport 事件被触发。

因此,通过使用不同对象的事件,可以控制报告形成的每一步。正确使用事件的关键在于充分理解上述 11 个步骤中阐述的波段打印过程。

因此,只需使用 "BeforePrint "带,就可以完成很多操作--对对象所做的任何更改都会显示出来。但在这种情况下,无法分析如果条带拉伸,将在哪一页打印,因为条带的高度将在第 6 步计算。

这可以借助第 7 步的 AfterLayout 事件或第 10 步的 AfterPrint 来完成,但在后一种情况下,条带已经打印,对对象的操作不会产生任何结果。

总之,您必须明确说明每个事件在哪个时刻触发,并使用与给定任务相对应的事件。

.Net 对象

在脚本中,您可以使用以下程序集中定义的任何 .Net 对象:

System.dll
System.Drawing.dll
System.Windows.Forms.dll
System.Data.dll
System.Xml.dll

除此之外,您还可以使用 FastReport 程序集中定义的任何对象。如果需要访问其他程序集,请将其添加到程序集列表中。这可以在 "Report|Options...(报告|选项...)"菜单中选择 "Script(脚本)"选项卡来完成:
fastreport

例如,如果要在报告中使用在应用程序中声明的函数,请在报告程序集列表中添加应用程序程序集(.exe 或 .dll)。然后就可以使用应用程序的命名空间调用该函数。例如,应用程序中定义了以下函数:

namespace Demo
{
public static class MyFunctions
{
public static string Func1()
{
return"Hello!";
}
}
}

在脚本中调用它的方法如下:

string hello = Demo.MyFunctions.Func1();


如果您使用的是 "Demo",那么它将允许您进行短合成:

string hello = MyFunctions.Func1();

在引用报告对象(例如 "Text "对象)时,请使用对象名称。下面的示例将返回 Text1 对象的高度:

float height = Text1.Height;

请注意,报表的原始测量单位是屏幕像素。在使用此类对象的左、上、宽、高等属性时,请牢记这一点。要将像素转换为厘米或更多,请使用 "Units "类中定义的常量:

float heightInPixels = Text1.Height; float heightInCM = heightInPixels / Units.Centimeters; Text1.Height = Units.Centimeters * 5; // 5см 

相关推荐

  1. 报表生成器Stimulsoft用户手册:表达式(

    2024-03-15 05:32:06       18 阅读

最近更新

  1. TCP协议是安全的吗?

    2024-03-15 05:32:06       19 阅读
  2. 阿里云服务器执行yum,一直下载docker-ce-stable失败

    2024-03-15 05:32:06       19 阅读
  3. 【Python教程】压缩PDF文件大小

    2024-03-15 05:32:06       19 阅读
  4. 通过文章id递归查询所有评论(xml)

    2024-03-15 05:32:06       20 阅读

热门阅读

  1. 2024年“新质生产力”是什么?新质生产力概述

    2024-03-15 05:32:06       20 阅读
  2. 在 Ubuntu 22.04 上源码安装 Podman 4

    2024-03-15 05:32:06       19 阅读
  3. 高速口光口通信

    2024-03-15 05:32:06       22 阅读
  4. 大模型在智能家居领域的应用与挑战

    2024-03-15 05:32:06       19 阅读
  5. FTP文件的上传与下载

    2024-03-15 05:32:06       20 阅读