Grid++-官方API文档

总体介绍 - 产品介绍概述Grid+Report是一款C/S与B/S集成报表工具，功能全面易学易用。C/S开发适用于VB.NET,C#,VB,VC,Delphi,BCB,VFP,易语言等。B/S开发适用于ASP.NET,ASP,PHP,JSP等，支持所有WEB服务器。开发C/S报表与B/S报表共享相同的开发知识与设计资源。提供独有的报表查询显示功能，让报表查询显示、打印、打印预览及数据导出等功能集成一体化实现。轻松实现通用报表、表格报表、动态报表、多层表头、票据与发票套打、交叉表、表中表及各种特殊报表等。提供详尽帮助文档与各种编程平台下的丰富例子，安装中包括可直接运行例子程序，安装后即刻体验此报表工具。包括简体中文版、繁体中文版与英文版。经过数年的发展，已经被多家有影响力的通用软件厂商采用，其用户遍布各行各业，已经成为用户受众面最广的国产报表开发工具。特点 支持C/S报表与B/S报表开发，支持众多开发工具与开发语言，C/S开发：VB.NET、C#、VB、VC、Delphi等，B/S开发：ASP.NET、ASP、PHP、JSP等，支持所有WEB服务器。 语言界面集成支持多国语言，同一程序支持多语言，可以实时切换界面语言。 功能强大，稳定高效：实现普通格式报表、表格报表、多层表头、票据套打、交叉表等各种报表非常简便；报表完全可编程定义，适合开发通用软件中的动态报表。 独有的报表查询显示功能：提供报表查询与输出的集成一次性实现，保证数据不同展现方式的一致性与完整性。 报表数据来源丰富：支持绑定与非绑定，一切数据库数据与其它数据都可以作为报表数据源；既可以设定数据源连接串与查询SQL语句绑定报表数据(报表数据拉模式)，也可以将应用程序中访问到的数据提供给报表(报表数据推模式)。 提供图表功能，包括：饼图、叠加饼图、柱状图，连线图、散列点图等。 报表数据导出格式丰富，格式包括：Excel、RTF(Word)、PDF、图像、HTML、文本，CSV 等。 支持所有常规条形码，条形码打印精度高易读取。 提供脚本编程功能，直接在报表模板中自定义报表行为，采用通用的VBScript与JScript脚本引擎。 特有的分组单元格合并功能，轻松实现常见的中国式报表分组在列中展现并垂直居中要求。 全中文界面，针对中国式报表进行了很多专门实现，如：表格报表、财务金额线、大写金额、发票圈叉图标、负数红字、多层表头等。很多在国外报表工具中很难实现的功能在本产品中可以轻易实现。 提供丰富交互事件，轻松实现报表行为自定义、穿透(透视)查询和报表交互。 重新发布简单：C/S报表只需分发两个DLL文件；B/S报表只要部署报表网页，WEB服务端全部采用开放技术，不需进行专门配置。 易学易用：完全可视化设计，完善的复制/剪切/粘贴(Copy/Cut/Paste)和恢复重做(Undo/Redo)功能，专业的拖放操作与即时编辑功能。 编写了完整详尽的帮助文档。提供了丰富例程，C/S报表包括VB.NET、C#、VB、VC、Delphi、C+Builder、VFP、中文编程易语言，B/S报表包括ASP.NET,ASP,PHP,JSP。 使用 Grid+Report 的常用方式 作为整个报表系统的整体解决方案的实现工具。利用 Grid+Report 的屏幕查询显示功能将报表在屏幕上显示出来，利用 Grid+Report 的打印与打印预览功能实现打印与打印预览。实现查询、打印与打印预览的统一实现，减少重复工作，并且能够保持数据一致性。 只使用 Grid+Report 的打印与打印预览功能，象其它报表构件一样使用，实现报表的分析与打印输出。 只利用 Grid+Report 的屏幕查询显示功能，Grid+Report 就像是一个具有超强数据展现功能的数据网格(DataGrid)控件, Grid+Report 可以对数据进行分组、统计、分析、显示等功能，通过对用户交互事件的处理达到与用户的互动。 用 Grid+Report 进行票据的套打，Grid+Report 对套打进行了专门的实现，使得套打位置的对齐特别便捷。 利用 Grid+Report 的数据导出功能，将应用程序中的数据导出到 Excel、PDF、html、Text、CSV、图像等格式文件。总体介绍 - 产品介绍概述Grid+Report是一款C/S与B/S集成报表工具，功能全面易学易用。C/S开发适用于VB.NET,C#,VB,VC,Delphi,BCB,VFP,易语言等。B/S开发适用于ASP.NET,ASP,PHP,JSP等，支持所有WEB服务器。开发C/S报表与B/S报表共享相同的开发知识与设计资源。提供独有的报表查询显示功能，让报表查询显示、打印、打印预览及数据导出等功能集成一体化实现。轻松实现通用报表、表格报表、动态报表、多层表头、票据与发票套打、交叉表、表中表及各种特殊报表等。提供详尽帮助文档与各种编程平台下的丰富例子，安装中包括可直接运行例子程序，安装后即刻体验此报表工具。包括简体中文版、繁体中文版与英文版。经过数年的发展，已经被多家有影响力的通用软件厂商采用，其用户遍布各行各业，已经成为用户受众面最广的国产报表开发工具。特点 支持C/S报表与B/S报表开发，支持众多开发工具与开发语言，C/S开发：VB.NET、C#、VB、VC、Delphi等，B/S开发：ASP.NET、ASP、PHP、JSP等，支持所有WEB服务器。 语言界面集成支持多国语言，同一程序支持多语言，可以实时切换界面语言。 功能强大，稳定高效：实现普通格式报表、表格报表、多层表头、票据套打、交叉表等各种报表非常简便；报表完全可编程定义，适合开发通用软件中的动态报表。 独有的报表查询显示功能：提供报表查询与输出的集成一次性实现，保证数据不同展现方式的一致性与完整性。 报表数据来源丰富：支持绑定与非绑定，一切数据库数据与其它数据都可以作为报表数据源；既可以设定数据源连接串与查询SQL语句绑定报表数据(报表数据拉模式)，也可以将应用程序中访问到的数据提供给报表(报表数据推模式)。 提供图表功能，包括：饼图、叠加饼图、柱状图，连线图、散列点图等。 报表数据导出格式丰富，格式包括：Excel、RTF(Word)、PDF、图像、HTML、文本，CSV 等。 支持所有常规条形码，条形码打印精度高易读取。 提供脚本编程功能，直接在报表模板中自定义报表行为，采用通用的VBScript与JScript脚本引擎。 特有的分组单元格合并功能，轻松实现常见的中国式报表分组在列中展现并垂直居中要求。 全中文界面，针对中国式报表进行了很多专门实现，如：表格报表、财务金额线、大写金额、发票圈叉图标、负数红字、多层表头等。很多在国外报表工具中很难实现的功能在本产品中可以轻易实现。 提供丰富交互事件，轻松实现报表行为自定义、穿透(透视)查询和报表交互。 重新发布简单：C/S报表只需分发两个DLL文件；B/S报表只要部署报表网页，WEB服务端全部采用开放技术，不需进行专门配置。 易学易用：完全可视化设计，完善的复制/剪切/粘贴(Copy/Cut/Paste)和恢复重做(Undo/Redo)功能，专业的拖放操作与即时编辑功能。 编写了完整详尽的帮助文档。提供了丰富例程，C/S报表包括VB.NET、C#、VB、VC、Delphi、C+Builder、VFP、中文编程易语言，B/S报表包括ASP.NET,ASP,PHP,JSP。 使用 Grid+Report 的常用方式 作为整个报表系统的整体解决方案的实现工具。利用 Grid+Report 的屏幕查询显示功能将报表在屏幕上显示出来，利用 Grid+Report 的打印与打印预览功能实现打印与打印预览。实现查询、打印与打印预览的统一实现，减少重复工作，并且能够保持数据一致性。 只使用 Grid+Report 的打印与打印预览功能，象其它报表构件一样使用，实现报表的分析与打印输出。 只利用 Grid+Report 的屏幕查询显示功能，Grid+Report 就像是一个具有超强数据展现功能的数据网格(DataGrid)控件, Grid+Report 可以对数据进行分组、统计、分析、显示等功能，通过对用户交互事件的处理达到与用户的互动。 用 Grid+Report 进行票据的套打，Grid+Report 对套打进行了专门的实现，使得套打位置的对齐特别便捷。 利用 Grid+Report 的数据导出功能，将应用程序中的数据导出到 Excel、PDF、html、Text、CSV、图像等格式文件。最终用户许可协议 - 产品介绍最终用户许可协议重要须知 请认真阅读：本最终用户许可协议（以下称协议）是您（个人或单一实体）与广州锐浪软件技术有限公司之间有关广州锐浪软件技术有限公司软件产品的法律协议。本“软件产品”包括计算机软件，并可能包括相关媒体、印刷材料，和“联机”或电子文档（“软件产品”）。本“软件产品”还包括对广州锐浪软件技术有限公司提供给您的原“软件产品”的任何更新和补充资料。任何与本“软件产品”一同提供给您的并与单独一份最终用户许可证相关的软件产品是根据那份许可协议中的条款而授予您。您一旦安装、复制、下载、访问或以其它方式使用“软件产品”，即表示您同意接受本协议各项条款的约束。如您不同意本协议中的条款，请不要安装或使用“软件产品”。本软件可以无限期试用，用户在购买前应充分试用以了解本软件，本软件一旦购买之后概不退款。软件产品许可证本“软件产品”受著作权法及国际条约款和其它知识产权法及条约的保护。本“软件产品”只许可使用，而不出售。一、许可证的授予。本协议授予您下列权利：l、授权使用范围。对一份软件产品，广州锐浪软件技术有限公司只授权您在一台电脑上面使用，但在下列情况下您可以将本软件用于多用户环境或网络系统上：广州锐浪软件技术有限公司明示授权许可您用于多用户环境或网络系统上；或您使用本软件的每一节点及终端都已向广州锐浪软件技术有限公司购买了使用许可。2、储存网络用途。您还可以在一个仅用于通过内部网络在您的其它计算机上运行“软件产品”的储存设备（如网络服务器）上存放或安装一份“软件产品”副本；但是，您必须为从储存设备运行“软件产品”的每一台计算机获得一份许可证。一份“软件产品”许可证不得在不同的计算机共同或同时使用。3、保留权利。未明示授予的一切其它权利均为广州锐浪软件技术有限公司所有。二、其它权利和限制的说明。1、对反向工程 (Reverse Engineering)、反向编译 (Decompilation)、反汇编 (Disassembly) 的限制。您不得对本“软件产品”进行反向工程、反向编译 (decompile) 或反汇编 (disassemble)，但尽管有这项限制，如适用法律明示允许上述活动，则不在此限。2、对竞争性产品的限制。 您不能将 Grid+Report 与对 Grid+Report 形成竞争的任何通用报表编写或报表制作产品一起使用、分发或集成；您不能使用本软件开发组件产品或组件集合，并且将其发布；也不能使用本软件或运行时间软件 创建通常对 Grid+Report 构成竞争的产品。3、商标。本协议不授予您有关任何广州锐浪软件技术有限公司商标或服务商标的任何权利。4、出租。不得出租、租赁或出借本“软件产品”。5、支持服务。广州锐浪软件技术有限公司可能为您提供与“软件产品”有关的支持服务（“支持服务”）。支持服务的使用受用户手册、“联机”文档和/或其它广州锐浪软件技术有限公司提供的材料中所述的各项政策和计划的制约。提供给您作为支持服务的一部分的任何附加软件代码应被视为本“软件产品”的一部分，并须符合本协议中的各项条款和条件。至于您提供给广州锐浪软件技术有限公司作为支持服务的一部分的技术信息，广州锐浪软件技术有限公司可将其用于商业用途，包括产品支持和开发。广州锐浪软件技术有限公司在使用这些技术信息时不会以个人形式提及您。6、软件转让。本“软件产品”不允许任何形式的转让。7、终止。如您未遵守本协议的各项条款和条件，在不损害其它权利的情况下，广州锐浪软件技术有限公司可终止本协议。如此类情况发生，您必须销毁“软件产品”的所有副本及其所有组成部分。三、升级版本。如本“软件产品”属于广州锐浪软件技术有限公司或另一供应商的另一产品的更新版本，则您只可根据本协议使用该更新版产品。如本“软件产品”是一套软件包中一个组成部分的更新版，而您的该软件包许可协议是将其视为一个单一产品，则您只可将本“软件产品”在该软件包下使用和转让，并不得将其在多台计算机上分开使用。四、著作权。本“软件产品”（包括但不限于本“软件产品”中所含的任何图象、照片、动画、录像、录音、音乐、文字和附加程序）、随附的印刷材料、及本“软件产品”的任何副本的产权和著作权，均由广州锐浪软件技术有限公司拥有。本“软件产品”受著作权法及国际条约条款保护。因此，您必须将本“软件产品”与任何拥有著作权的资料同样对待；但下列情况除外：a)、只为备份或存档目的而保存原件；b)、您可在一台单一计算机上安装本软件产品，但您不得复制本软件产品随附的印刷材料。五、多种媒体软件。您可以由多种媒体获得“软件产品”。无论您收到何种类型或大小的媒体，您只可使用适用于您单一的计算机的一种媒体。您不可在另一台计算机上运行另一种媒体。除作为“软件产品”永久转让的一部分外（如上文所述），您不得将另一种媒体出借、出租或租赁或以其他方式转移给另一用户。六、备份副本。在按照本协议安装一份本“软件产品”副本后，您可以保留广州锐浪软件技术有限公司用以提供给您本“软件产品”的原媒体，仅用于备份或存档之用。如果需要原媒体方可在计算机上使用“软件产品”，您可以复制一份“软件产品”副本仅用于备份或存档之用。除本协议中明文规定外，您不可复制本“软件产品”或随附本“软件产品”的印刷材料。七、产品分发限制。Grid+Report 是一种软件组件(构件)，您可以在您的程序中分发 Grid+Report，但需遵守以下约定：1、用户开发出来的产品或程序模块只能用在您的项目中，不能单独以 OCX、DLL 及其它的具有组件(构件)性质的产品的形式进行销售，转让、租赁、借用的方式提供给其他的公司或个人使用。您如果违反本约定，应承担赔偿责任，赔偿额为您所购买软件的10倍金额，或者是违约所得额或者对方的损失额，以三者中的较高者为准。八、损害不负责赔偿责任。在相关法律所允许的最大范围内，广州锐浪软件技术有限公司或其供应商因使用或不能使用本软件产品所发生的损害(包括，但不限于营业利益的损失，营业中断，商业信息遗失，数据或代码损坏，程序运行出错)不负责赔偿责任，即使是广州锐浪软件技术有限公司事先被告知该损害发生的可能性。不论任何情况，广州锐浪软件技术有限公司就任何条款应负的责任总额，以您就该软件产品所实际已支付的价款为限。备注：1、用户购买本产品企业版，只能在同一局域网中的（TCP/IP协议）某一个子网内无限开发使用。2、用户购买以上所有产品均可无限分发，你可以把用本产品开发出来的软件无限制的分发，但不能用本产品开发出来的OCX、DLL及其它的具有ACTIVEX性质的产品进行销售、转让、租赁、借用的方式提供给其他的公司或个人使用。3、本协议受中华人民共和国法律管辖。如果您对本协议有什么问题，或您有事想同广州锐浪软件技术有限公司联系，请与广州锐浪软件技术有限公司联系。通讯地址：广州市中山大道中35号3座14楼邮政编码：510660电 话：(020)82520837（服务热线）网 站：电子邮件：（销售） （技术支持）版本介绍 - 产品介绍概述Grid+Report报表开发工具分为报表组件与报表插件这两个不同授权方式。报表组件是用来开发桌面软件的报表系统，也就是通常所说C/S报表开发。报表插件是进行WEB软件的报表开发，也就是通常所说的B/S报表开发。C/S开发适用于VB.NET, C#, VB, VC, Delphi, C+Builder, VFP, 易语言等。B/S开发适用于ASP.NET, ASP, PHP, JSP等，支持所有WEB服务器，如IIS、Tomcat、WebLogic、Websphere等。开发C/S报表与B/S报表共享相同的开发知识与设计资源。报表组件版本划分我们将授权使用的范围划分为单机开发版与企业开发版。单机开发版只允许在一台机器上使用 Grid+Report 进行开发，企业版可以在一个局域网范围内的所有电脑上开发。用任何一个版本开发的应用程序分发时免费，即应用程序开发者可以包括 Grid+Report 的发布文件无限免费发布其软件；两个版本的功能都是完全一样的。版本特点单机开发专业版在同一时间只允许在一台机器上开发使用，开发出来的软件可以无限分发。企业开发专业版可以在一个局域网范围内的所有机器上开发使用，开发出来的软件可以无限分发。报表插件版本报表插件分两种注册方式：按 WEB 服务器注册与无限分发版注册。两种注册方式客户端无需任何注册，客户端数量也没任何限制。版本特点按服务器注册每台要部署报表插件的WEB服务器需要购买注册许可。根据服务器域名(DNS)或IP地址生成注册号。报表插件开发无需授权，购买后终身免费升级。无限分发版注册在设计报表模板时需要注册，部署服务器数量不限。产品小版本升级免费，购买后可以按升级价格购买升级到新的大版本。有关产品版本的最新信息请参考：/grprice.htm关于免费使用Grid+Report从锐浪软件网站下载的软件可以免费使用，除了显示试用标志外，没有任何功能限制与使用期限限制。试用标志只在屏幕上显示，不会打印输出。Grid+Report 这样的试用方式是希望有更多的软件开发者使用 Grid+Report，希望把使用国外报表工具与其它免费报表工具的开发者吸引到使用 Grid+Report 的行列中。用 Grid+Report 开发中国式报表具有不可比拟的优势，欢迎广大软件开发者使用优秀国产报表开发工具。为了 Grid+Report 的持续发展，我们不能将试用标志完全取消，请大家理解，同时也希望有条件的用户注册购买。只要能接受 Grid+Report 的试用标志输出方式，任何开发者都可以免费使用它。我们认为以下情况更适合免费使用：1. 学习报表开发。 2. 大学生毕业设计。 3. 开发企事业单位内部软件系统。 4. 开发免费软件。 5. 尚未实现收益的商业软件与共享软件。更多有关免费使用的信息请参考：/doc/about_trialflag.htm注册购买 - 产品介绍关于试用 Grid+Report 的说明：从网站: 下载的 Grid+Report 就可以试用，例子都在安装目录下，试用时除了有试用标志显示，没有任何功能与时间期限限制。我们并没有制作专门的试用版程序，购买用户与试用用户是同一个程序安装包，购买后按照注册说明进行处理就可以去掉试用标志。Grid+Report快速入门指导请参考: 帮助的“产品介绍-快速入门指导”部分 或 /doc/get_starting.htm 。购买 Grid+Report：购买本产品的有关信息请访问我们的网站: 或按下面的联系方式与我们联系。购买本产品的用户会得到以下方面的便利：1. 更好更及时的技术支持服务：对于购买用户，在技术支持的优先级别上更高，提出的问题将优先得到解决。2. 对购买产品的用户提供免费 QQ 技术支持。3. 对购买产品的用户提供免费的电话与Email技术支持。4. 对于购买产品的用户提出的合理需求将考虑尽力实现。5. 在产品界面上不会显示任何标志性的图标与文字，让你的产品与项目更完美。6. 为购买产品的用户提供报表解决方案方面的咨询。购买产品联系方式： 销售热线售Email：销售QQ： 641243789 1067004956销售MSN：关于技术支持 - 产品介绍关于技术支持如果你在使用过程中遇到疑问与困难，我们建议通过以下几种方式自己解决问题：1. 认真查看例子，看是否有类似的例子可以帮助你解决问题。2. 阅读帮助中的相关部分，认真理解相关说明。3. 阅读帮助文档中常见问题解答(FAQ)。4. 上我们的网站论坛，搜索前面是否有人提出类似的问题，如果没有你也可以在论坛中提出你的问题。5. 给我们的技术支持来EMail,如果在论坛中适合提出你的问题,我们建议在论坛中提出问题,因为除了我们会为你提供解答之外,说不定还有热心的程序员朋友会解答你的问题,另外在论坛中你提出的问题为大家所共享,这也是我们期望的。6. 购买产品的用户将得到我们免费的电话技术支持。7. 购买用户可以通过我们的技术支持QQ与我们直接交流。申请试用技术支持为了让开发者更快地了解与评估 Grid+Report，我们对试用本报表的试用者免费提供在一定期限内与购买用户一样的技术支持服务。在安装目录下有“试用用户信息表.doc”这个表格文件，开发者如实填写这个表格，然后发送给我们。在开发者提交的试用技术支持申请信息在我们确认真实有效之后，我们会把多种技术支持方式的信息发送给申请者，包括电话、EMAIL、QQ等。网站：电子邮件：软件安装 - 产品介绍软件要求：开发时：Grid+Report 可以在任何支持 COM 的开发平台上使用，主要包括：Delphi、 C+Builder、Visual Basic、Visual C+、Visual B、C#与E中文编程语言等。发布时：支持所有微软 Windows 系列操作系统，从最早的 Windows95 到最新推出的 Windows Vista。Windows95 需要安装微软 Internet Explorer 5.0或以上版本。硬件要求：Grid+Report 对硬件没有任何特别要求，只要硬件满足开发平台的要求就可以顺利地使用 Grid+Report 进行开发。安装 Grid+Report运行 Grid+Report 的安装程序，按照提示一步步完成安装过程，安装完成之后，Grid+Report 作为一个 COM 组件已经注册到 Windows 操作系统注册表中。下一步就是按照各种开发平台使用 COM 组件的方法准备使用 Grid+Report。在“几种开发平台中使用”一节中有几种常用开发平台准备使用 Grid+Report 的专门说明。在安装目录下有各种编程语言的大量例子，建议大家参考学习。关于帮助文档 - 产品介绍Grid+Report的帮助文档主要包括这几部分：产品介绍、设计报表、报表组件(C/S报表)、报表插件(WEB报表)、编程参考等。涉及了用Grid+Report进行报表开发的方方面面。产品介绍部分对产品的基本情况进行介绍，说明了产品的运行原理，以及获取更多技术支持等方面的信息。设计报表部分介绍了Grid+Report的报表设计器程序的用法，阐述各种报表的设计过程。无论是WEB报表开发，还是桌面报表开发，都首先要用报表设计器程序设计报表模板。开发指南部分介绍通用于C/S报表开发与B/S报表开发的有关报表编程开发相关的知识。C/S开发与B/S开发共用相同的编程接口，如果实现相同的功能，各种编程语言除了语法书写上的差别，其程序代码都是类似的。报表组件(C/S报表)部分介绍用Grid+Report开发C/S报表的方方面面。报表插件(WEB报表)部分介绍用Grid+Report开发B/S报表的方方面面。编程参考部分是Grid+Report内部编程接口的帮助，所有的编程接口帮助都包含在这里，每个属性与方法都有详细的说明。当在查阅例子程序时，如不明白与报表相关代码的意义，可以在此部分帮助中查看相关接口。在帮助的索引中输入关键词快速定位到对应的帮助主题。如果要用程序定义报表模板，建议看明白其中的编程组件对象模型图，借其理解整个报表的定义结构模型，并查阅对应接口的编程参考。快速入门指导 - 产品介绍指导流程图Grid+Report非常易学易用，下面我们给出一个指导性的学习流程，按照这个流程可以很快上手使用Grid+Report进行报表开发。下载安装 Grid+Report下载地址: /download.htm从这里下载最新版本Grid+Report。下载完成后解压缩下载文件，然后运行解压的文件即可启动安装程序，逐步执行即可完成安装。运行与查看例子Grid+Report的相关例子都在安装目录下，通过查看与运行例子,可以直观了解与体验Grid+Report的功能。这里假设Grid+Report安装在“C:Grid+Report 5.0”下，下面分别对各部分例子进行说明。1. 可直接运行例子应用程序：位于“C:Grid+Report 5.0SamplesApplication”目录下，执行各个应用程序可以直接体验Grid+Report的功能。2. 例子报表模板：位于“C:Grid+Report 5.0SamplesReports”目录下，是各种典型格式的报表模板。双击各个文件会用Grid+Report 的报表设计器程序打开，进入报表设计器的“预览视图”与“查询视图”可以查看报表的运行效果。3. C/S报表组件例子程序：位于“C:Grid+Report 5.0Samples%编程语言%”目录下，这里是各种编程语言下应用Grid+Report进行C/S报表开发的例子源程序。在打开例子程序编译运行之前，很多编程语言需要进行相应的配置处理，请看下面的“C/S报表开发配置开发环境”部分。4. B/S报表插件例子程序：位于“C:Grid+Report 5.0WebSamples%编程语言%”目录下，这里是各种编程语言下应用Grid+Report进行WEB报表开发的例子程序。如何运行与查看这些例子，请看帮助中“报表插件(WEB报表)-WEB报表例子”的具体说明。设计报表模板在对Grid+Report有所了解后，就可以开始进行报表模板设计。无论是C/S报表开发，还是B/S报表开发，都需要设计报表模板。两种报表开发共享一样的报表模板设计方法，报表模板对两种报表开发也是通用的。启动Grid+Report报表设计器程序开始设计报表模板。帮助中“设计报表-设计第一个报表演练”中描述了设计一个报表模板的具体步骤，建议照此描述学习设计一个报表模板。C/S报表开发配置开发环境帮助中“报表组件(C/S报表)-开始使用-在各种开发平台下使用”中描述了在各种编程语言下使用Grid+Report需要进行的准备工作。C/S报表开发在程序中运行报表可以参考与模仿对应编程语言的例子程序，在程序中加入用Grid+Report实现的报表与打印功能。“1.Tutorial”这个例子是最简单的，开始可以模仿这个例子制作一个最简单的报表程序。B/S报表开发实现数据服务网页数据服务网页负责向WEB报表提供报表数据，这也是WEB报表能够运行的前提条件之一。建议看懂对应编程语言的WEB报表例子，并复用例子中的通用代码。一般报表的数据服务网页程序非常简单，就是提供一个查询SQL语句，并调用一个产生报表数据包的函数。B/S报表开发在网页中显示报表首先需要在网页中加入报表显示插件，报表显示插件实现在网页浏览器中展现报表。通过报表显示插件的属性指定关联的报表模板文件与报表数据服务网页，在浏览器加载有报表插件的网页时，报表就会在网页中显示出来。例子中提供了“CreateControl.js”这个通用的js程序用来在网页中加入插件并设置其相关属性，强烈建议采用这样的方式。“TutorialPrintViewReport.htm”与“TutorialDisplayViewReport.htm”这两个例子网页是一个最简单的范例，分别以打印预览与查询显示方式展现报表。更多说明Grid+Report具有强大的功能，并具有非常灵活的可编程性。在初步了解Grid+Report开发报表的知识后，建议多看我们的帮助文档与例子程序，以便更好的发挥其功能。当需要用程序代码动态定义与控制报表运行行为，请参考帮助中“编程参考”部分获取编程接口方面的帮助。产品组成部分 - 产品概念与原理产品组成部分概述Grid+Report 为报表开发者提供四个外层构件，报表开发人员通过对这四个构件的使用为最终用户提供完善的报表系统。报表主对象是不可视的，其它三个构件都是可视的。以下是对四个构件对象的简要叙述。报表主对象（GridppReport）一个不可视的组件对象，定义报表的模板数据，在生成报表时存贮报表记录数据，对数据进行加工处理。生成打印页面，输出打印页面到打印机。报表主对象是整个产品中最基础的构成部分，通过报表主对象可以访问报表中的各个子对象。查询显示器（GRDisplayViewer）一个 ActiveX Control。在使用时关联一个报表主对象。开始运行时向报表主对象发出生成数据请求，然后本构件显示报表主对象生成的数据，本对象为最终用户提供了完善的查看数据的操作。报表开发者通过对本对象交互事件的响应，可以为报表最终用户提供可交互的报表查询功能。例如通过对汇总报表的明细网格内容格的双击事件的响应，打开对应的明细报表，达到从汇总报表到明细报表的穿透查询。通过该控件实现报表查询显示功能也是 Grid+Report 独有与独创的。打印查看器（GRPrintViewer）一个 ActiveX Control。在使用时关联一个报表主对象。开始运行时向报表主对象发出生成数据请求，并生成打印页面数据，然后本构件显示生成的打印页面，并且提供其它相应的页面操作与打印操作。报表开发人员可以通过提供外部操作界面来执行构件接口的方法与属性，为最终用户提供报表打印预览界面。虽然 Grid+Report 在内部提供了报表打印预览窗口，但使用本控件开发者可以实现自己个性化的打印预览窗口。报表设计器（GRDesigner）一个 ActiveX Control。在使用时关联一个报表主对象。由三个窗口组成：其一是报表布局窗口，主要可以在其中设置报表显示元素的大小、位置、显示顺序等。其二是属性编辑窗口，可以在其中查看与修改选中对象的属性值。其三是对象浏览窗口，显示出所有报表元素对象，可以在此窗口中对报表元素进行选中操作。构件接口提供执行各种设计任务的动作方法，报表开发人员通过提供外部操作界面执行动作方法，为最终用户提供运行时的可视化自定义报表设计器。报表模板 - 产品概念与原理报表模板报表模板就是指报表的样式定义信息，报表在运行时根据报表模板与报表数据综合加工产生出报表。报表模板通常用报表设计器进行设计，并保存为磁盘文件。报表模板也可以完全用程序代码定义出来。报表模板文件报表模板文件就是保存报表定义信息的文件，文件的扩展名缺省为 .grf，在 Windows 资源管理器中双击扩展名为 .grf 的文件可以启动 Grid+Report 的设计器应用程序并打开该模板文件。在设计时，设计器的设计结果要永久保存，必须存储到文件中，此种类型文件称为 Grid+Report 报表模板文件。在下一次进入设计器后可以打开以前保存的模板文件。在运行时，一个报表主对象一般是从报表模板文件载入报表的定义，然后进行报表的生成处理。报表模板存储报表模板通常磁盘文件，但也可以保存为其它形式，保存在数据库中，或其它存储形式中。报表运行过程 - 产品概念与原理Grid+Report的生成过程：报表模板 + 记录数据 + 报表引擎 + 事件响应 = 输出（屏幕显示，打印与打印预览，导出格式文件）+ 用户交互1. 首先定义报表模板。一般将报表设计器设计的模板文件载入到报表主对象中，也可以通过编程的方式定义报表模板。2. 开始生成报表，响应 FetchRecord 事件向报表中填充明细记录。3. Grid+Report 报表引擎对填充的记录进行分析加工，如对记录进行分组、统计数据等。4. 如果是在查询显示器中显示报表，加工处理的数据显示在查询显示器中，用户可以对显示的数据进行操作。5. 如果是打印生成，Grid+Report 根据页面设置信息将加工处理的数据生成一页页的打印页面数据，同时生成与页面相关的数据，如当前页号，总页数。6. 接第5，如果是打印预览，生成的打印页面显示在打印查看器中。7. 接第5，如果是输出到打印机进行打印，生成的打印页面被送到打印机进行打印。报表节 - 产品概念与原理报表节概述Grid+Report 的显示由各种类型的节组成，每个节中包含一组部件框或单元格，部件框在生成时根据内容输出显示。Grid+Report 的报表节可以分成两大类：一是报表主对象直接拥有的报表节，包括报表头、报表尾、页眉、页脚；二是属于明细网格的报表节，包括标题行、内容行、分组头、分组尾。（图）各种节在设计器中的示例各种类型的报表节的简要说明报表头报表头在打印生成时，如果不选择每页重复输出，则只在报表的开始生成时显示一次；在屏幕查询显示时，显示在明细网格之上。一个报表可以定义多个报表头，在一般情况下我们只需定义一个报表头。在报表头中一般定义报表的标题，报表标识信息，徽标图像及其它只需在报表开始时显示一次的信息。报表尾报表尾在打印生成时，如果不选择每页重复输出，则只在报表的最后输出一次；在屏幕查询显示时，显示在明细网格之下。一个报表可以定义多个报表尾，在一般情况下我们只需定义一个报表尾。在报表尾中一般定义报表的统计信息及其它只需在报表结束时显示一次的信息。页眉页眉在打印生成时，输出在每页的上边距之上；在屏幕查询显示时，页眉被忽略掉，即屏幕查询显示不使用页眉。一个报表只能定义一个页眉。在页眉中一般定义页号，总页数，文档名称，打印时间及其它需要显示在输出纸张页眉区域的信息。页脚页脚在打印生成时，输出在每页的下边距之下；在屏幕查询显示时，页脚被忽略掉，即屏幕查询显示不使用页脚。一个报表只能定义一个页脚。在页脚中一般定义页号，总页数，文档名称，打印时间及其它需要显示在输出纸张页脚区域的信息。标题行标题行显示在明细网格的最上端，一般只在明细网格开始时输出一次。明细网格标题按照明细网格的列定义被划分成一个个单元格，形成明细网格的标题格。一般在明细网格的标题格中定义列的标题文字。内容行内容行显示在明细网格标题之后，按照明细网格的数据集记录的顺序每个记录生成一次内容行，如果定义有分组，在每个分组开始与结束时，要插入分组头与分组尾的生成。明细网格内容行按照明细网格的列定义被划分成一个个单元格，形成明细网格的内容格。一般每个明细网格的内容格关联一个记录集字段，用来显示字段的内容。分组头与分组尾一个报表可以定义一个或多个嵌套分组，每个分组对应一个分组头与一个分组尾。分组头显示在每个分组项开始时，一般在分组头上定义分组的标识信息，分组初始值及其它只需在分组项开始时显示一次的信息。分组尾显示在每个分组项结束时，一般在分组尾上定义定义分组的统计信息及其它只需在分组项结束时显示一次的信息。明细网格 - 产品概念与原理明细网格概述明细网格的作用就是显示报表的明细数据，一般的报表都需要一个明细网格，明细网格一般生成在报表头之后及报表尾之前。一般情况下，明细网格构成一个报表的主体，报表的主要信息输出在明细网格中，明细网格由实现明细数据生成与输出需要的多种子对象组成。组成明细网格不可显示的子对象有：1. 记录集2. 字段3. 分组4. 列组成明细网格可显示的子对象有：1. 标题行2. 标题格3. 内容行4. 内容格5. 分组头6. 分组尾记录集存储与操作明细记录的对象，当添加明细网格之后，明细网格就自动拥有记录集对象。记录集由多个字段组成。在运行时，提供给报表的明细记录数据被存储到此对象中。报表开发者通过设置数据库连接串与查询SQL，报表在设计时与运行时根据此设置取得供明细记录数据。如果没有设置数据库连接串与查询SQL或指定在运行时不根据数据库连接串与查询SQL设置取明细记录数据，则必须在 FetchRecord 事件中填充记录集数据。字段定义记录的每个数据项，字段有表示不同数据类型的具体类型。运行时，记录数据的读写就是通过各个字段值的读写实现。分组对所有的记录数据归类的定义，一个报表可以定义一个或多个分组，每个分组对应一个分组头与一个分组尾。分组本身在输出时不能显示出来，分组信息的显示在分组头与分组尾中。列定义明细网格的列信息。每个列有显示宽度属性，每个列对应一个标题格，显示在标题行上，一个内容格，显示在内容行上。一般情况下，如果一个字段的数据要显示出来，就需要定义一个对应的列。列本身在输出时不能显示出来，而是通过标题格与内容格的显示来体现列的输出。标题行标题行一般显示在明细网格的最上端，通常只在明细网格开始时输出一次。标题行拥有所有标题格，标题行显示区域被一个个标题格所划分。标题格每当增加一个明细网格的列之后，都会在标题行添加一个对应的显示单元格；当我们需要定义多层标题时，具有下级标题的标题也要在标题行添加一个对应的显示单元格，这两种方式的单元格称为标题格。一般在明细网格的标题格中定义列的标题文字。如果把标题格设为自由格，则标题格成为部件框容器，可以向标题格添加部件框。内容行内容行显示在明细网格标题之后，内容行按照明细网格的记录顺序每个记录显示一次，如果定义有分组，在每个分组开始与结束时，要插入分组头与分组尾。内容行拥有所有内容格，内容行的显示区域被一个个内容格所划分。内容格每当增加一个明细网格的列之后，都会在内容行添加一个对应的显示单元格，此种显示单元格称为内容格。一般每个内容格关联一个字段，用来显示字段的内容。如果把内容格设为自由格，则内容格成为部件框容器，可以向内容格添加部件框。分组头一个报表可以定义一个或多个分组，每个分组对应一个分组头与一个分组尾。分组头显示在每个分组开始位置，一般在分组头上定义分组的标识信息，分组初始值及其它只需在分组开始时显示一次的信息。分组尾一个报表可以定义一个或多个分组，每个分组对应一个分组头与一个分组尾。分组尾显示在每个分组结束位置，一般在分组尾上定义分组的统计信息及其它只需在分组结束时显示一次的信息。报表部件框 - 产品概念与原理部件框概述部件框是对报表中最基本可显示单元的统称，部件框在其父容器中占据一个矩形区域，部件框的内容输出在此矩形区域中，部件框包括背景填充方式与背景色、边框输出模式、以及具体类型的部件框的内容输出前景色。Grid+Report 包括如下具体类型的部件框： 综合文字框 静态框 字段框 统计框 系统变量框 图形框 线段 图像框 RTF文本框 子报表 图表 条形码综合文字框综合文字框可以显示静态文本，关联动态数据域，动态数据域包括：字段、参数、文字部件框、统计函数与系统变量。综合文字框可以定义四则运算表达式，在运行时表达式被替换为运算结果。综合文字框是 Grid+Report 中最常用的部件框，它除了可以实现其它文字框的功能外，还可以组合静态文字与动态数据域，在运行时输出动态变化的文本，另外数据域还可以使用在四则运算表达式中，在运行时输出运算结果。静态框用来显示静态文本的部件框，一般在设计时设定要显示的文本，在输出显示时根据输出格式信息将显示文本画出来。静态框可以关联某个参数对象，在这种情况下，在输出显示时部件框的显示文本为参数对象的显示文本，当一个部件框在输出时要显示多次，而其关联的参数对象的值是变化的，则此静态框在不同位置输出时的显示文字是变化的。静态框是为了保持与以前版本的兼容而保留下来的部件框，建议新的报表使用综合文字框。字段框用来显示字段内容的部件框，在设计时关联一个字段对象，在输出显示时根据输出格式信息将字段对象在当前记录的显示文本画出来。字段框一般使用在明细网格的自由内容格、分组头、分组尾中。统计框用来显示统计数据的部件框，在设计时设定某种统计函数，除计数（Count）函数外，其余统计函数都需要关联一个字段对象。在统计框中可以定义统计值的输出格式。统计框一般使用在分组头与分组尾中。有时为了统计全部记录的统计数据，可以将部件框使用在报表尾与报表头中。系统变量框用来显示系统变量值的部件框，在设计时设定某种系统变量，在系统变量框中可以定义值的输出格式。系统变量框可以使用在任何部件框容器中，例如页号、页总数一般使用在页眉与页脚中。图形框用来显示各种图形的部件框，在设计时设定某种图形类别，并设定该种图形的一些参数信息。图形框一般用来对报表进行一些修饰。线段专门输出线段的部件框。 图像框用来显示多种格式图像的部件框，图像数据可以直接保存在报表模板文件中，也可以在运行时从磁盘文件、二进制字段和内存中载入。RTF文本框用来显示RTF格式文本的部件框，RTF格式文本数据可以直接保存在报表模板文件中，也可以在运行时从磁盘文件、二进制字段和内存中载入。子报表专门用来在当前报表中输出另外一个报表的内容的部件框。在报表运行之前，必须为子报表关联报表对象。