易语言使用Grid++Report起步教程

易语言使用Grid++Report起步教程概述：在本教程中，首先介绍用 Grid++Report 的报表设计器应用程序设计一个简单的清单式报表，我们最后会得到一个与 Grid++Report 例子模板中的‘简单列表.grf’类似的报表模板。

接下来我们学习怎样让‘简单列表.grf’例子模板在易语言程序中运行起来。

首先实现报表的打印与打印预览功能，通过本部分的学习我们可以得到一个类似本教程附带的‘打印与打印预览报表.e’程序。

然后我们学习利用Grid++report 的查询显示器控件实现报表在窗口中的查询显示，我们会创建一个类似本教程附带的‘在查询显示控件中显示报表.e’程序。

通过本教程的学习，你将对 Grid++Report 报表模板设计与在易语言中使用 Grid++Report 有一个初步与直观的了解，开启你用 Grid++Report 在易语言中开发报表的大门，为你更进一步学习奠定了良好的开端。

具备一定的数据库方面的知识对开发报表非常重要，因为报表一般都需要从数据库中取数据,然后由报表工具生成出来，你应该对数据库方面的一些基本概念有所了解，能够写出基本的 SQL 查询语句。

如果你具备这些基础知识，你学习用 Grid++Report 在易语言中开发报表会非常容易，如果你觉得这方面有所欠缺，建议你加强这方面的学习。

本教程适用于第一次接触 Grid++Report 或对 Grid++Report 在易语言中使用还没有入门的易语言开发者。

完成本教程的学习之后，建议你浏览并运行一遍 Grid++Report 自带的全部易语言例子，对 Grid++Report 的功能有所了解。

使用本教程你必须安装易语言的4.0或以上版本。

必须安装 Grid++Report 报表组件，可以去下载最新的 Grid++Report。

为了顺利完成本教程，你应该将 Grid++Report 安装在 C:\Program Files\Grid++Report 3 目录下。

教程包括以下内容：∙第一节：创建报表模板∙第二节：配置 Grid++Report 在易语言中的使用∙第三节：实现报表打印与打印预览∙第四节：实现报表在查询显示控件中显示第一节：创建报表模板∙创建一个空白的报表模板1.从 Windows 桌面执行‘开始->程序->Grid++Report 3.6->Grid++Report 报表设计器’启动报表设计器应用程序。

此时一个空白的报表模板创建在报表设计器应用程序中。

∙定义报表头1.执行菜单命令‘插入->报表头’，一个新的报表头被创建。

2.执行菜单命令‘插入->静态框’，将鼠标光标移动到报表头之上，拖放鼠标创建一个静态框，其‘名称’ 属性应为‘StaticBox1’。

3.设置 StaticBox1 的‘文本’属性设为‘客户基本信息’。

4.设置 StaticBox1 的‘居中’属性设为‘水平’,使标题文字在水平方向上居中显示。

5.设置 StaticBox1 的‘字体’属性为‘宋体、粗体、小三’。

6.在 StaticBox1 上单击鼠标右键弹出关联菜单，执行命令‘自动调整大小’将 StaticBox1 的大小自动调整到合适。

7.执行菜单命令‘文件->保存’保存文件，在文件对话框选择合适的目录位置并输入文件名‘简单列表’。

至此我们已经完成报表头的定义。

∙插入明细网格1.执行菜单命令‘插入->明细网格’，明细网格被创建。

一个明细网格已经添加到报表定义中。

∙绑定明细网格数据说明：Grid++Report 采用 Windows 操作系统自带的 OLE DB 数据引擎从数据源获取报表数据, OLE DB 数据引擎是微软最新最先进的数据操作引擎,支持各种普通数据库与多种非数据库数据源。

下面的过程中我们将学习怎样从 Grid++Report 例子数据库获取报表明细数据，Grid++Report 例子数据库是一个 Access 数据库。

1.执行菜单命令‘报表->数据库查询...’，‘设置数据库连接串与查询SQL’对话框打开。

2.在‘设置数据库连接串与查询SQL’对话框中，执行‘创建数据库连接串...’按钮，此时创建 OLEDB 数据链接属性窗口打开。

3.在‘OLE DB 提供程序’列表框中选择‘Microsoft Jet4.0 OLE DB Provider’。

然后执行‘下一步(N)>>’按钮。

4.执行‘选择或输入数据库名称’编辑框右边的‘...’按钮，从打开的‘选择 Access 数据库’对话框中选取 Grid++Report 的例子数据库，如果 Grid++Report 安装在 C 盘的默认目录，这个Access 数据库文件就是‘C:\Program Files\Grid++Report 3\Samples\Data\Northwind.mdb’。

5.执行‘确定’按钮，数据链接串已经成功创建，我们可以在设置数据库连接串与查询SQL对话框的‘数据库连接串’编辑框中看到我们刚才创建的数据库连接串。

6.在‘查询SQL’编辑框中输入‘select * from Customers’，注意不要包括引号，表示我们从Customers 表中取其所有数据。

7.[可选]执行‘测试’按钮验证数据库连接串与查询 SQL是否正确设置。

8.执行‘确定’按钮关闭设置数据库连接串与查询SQL对话框，至此我们已经完成报表明细数据的绑定。

(上图)设置数据库连接串与查询 SQL 对话框(上图)OLE DB 数据链接属性窗口生成报表数据集的字段1.执行菜单命令‘编辑->根据查询生成字段’，此时 Grid++Report 将根据我们上一步中创建的数据库连接串与查询 SQL 参数自动生成报表明细记录集的字段,生成的字段与数据库表中的字段保持一致。

2.[可选]执行菜单命令‘报表->字段集合...’，打开‘字段集合’对话框中我们可以看到刚才自动创建的各个字段。

(上图)字段集合对话框至此我们已经完成了报表数据绑定与数据存储方面的定义工作，下一步就是怎样将报表数据展现出来。

定义明细网格的列1.执行菜单命令‘编辑->根据字段生成列’，此时 Grid++Report 将根据报表当前明细记录集字段的定义生成明细列，每个字段将对应生成一个显示列，此时我们可以看到在明细网格的定义界面上多了很多列的显示。

2.[可选]选中标题行中的某个格，在属性编辑窗口中改变其‘文本’属性，可以为每个列标题设置合理的显示文本。

3.[可选]执行菜单命令‘报表->列标题布局...’，打开‘列标题布局’对话框；通过执行‘上移’与‘下移’按钮，或通过拖放左边列表中的节点，我们可以改变列的显示顺序。

4.[可选]在明细网格的定义界面上部的标尺为列宽度指示标尺，将鼠标停放在两个标尺之间的间隔区域，通过拖放可以改变列的显示宽度，通过这样的操作我们可以为每个列设置合理的显示宽度。

(上图)列标题布局对话框至此一个与例子模板‘简单列表.grf’类似的报表已经定义出来，通过点击设计器下端的‘预览视图’与‘查询视图’切换按钮我们可以及时看到报表的运行效果，其实在整个设计过程中，我们都可以随时进入预览视图与查询视图，及时查看报表的运行效果。

当然我们还没有定义报表的页眉与页脚，通过执行菜单命令‘插入->页眉’或‘插入->页脚’，我们很容易将页眉与页脚定义出来。

(上图)整个设计过程得到的报表说明：1.以上操作步骤按设计器应用程序的主菜单的执行过程介绍，很多操作过程都存在对应的右键弹出式关联菜单与工具栏按钮，明细网格上端的工具栏中的按钮也可以完成与明细网格相关的操作，这些便捷的操作方式大家会在以后的设计过程慢慢熟悉。

2.以上这个简单的报表设计过程我们也可以通过报表创建向导来完成，如果我们理解了以上报表的设计过程，我们也很容易通过创建向导来定义报表。

通过执行菜单命令‘文件->向导...’,启动Grid++Report 报表创建向导。

3.Grid++Report 既支持数据绑定，也支持数据非绑定。

数据绑定是指 Grid++Report 在报表运行时根据设定的数据连接串与查询 SQL 语句主动从数据源取入数据，上面我们创建的就是一个数据绑定报表。

而数据非绑定报表在运行时，Grid++Report 会触发 FetchRecord 报表事件，报表开发者在程序中通过此事件将数据填入到报表。

在设计数据非绑定报表时，不用设定数据连接串与查询 SQL 语句，因此也不能自动生成字段定义，因此我们需要在‘字段集合’对话框中逐个增加字段定义。

4.要了解更多有关 Grid++Report 的知识与进一步学习 Grid++Report,请查看产品安装之后的帮助文档、例子报表模板、例子源程序与访问我们的网站。

目前 Grid++Report 提供的例子源程序包括、C#、VB、VC、Delphi、C++Builder与易语言。

第二节：配置 Grid++Report 在易语言中的使用安装 Grid++Report 的 NPK 文件：1.首先运行易语言。

2.执行菜单‘工具’→‘类型库或OCX组件->支持库’，打开类型库创建与安装窗口。

3.安装 gregn3.npk 文件：点击‘安装’按钮，打开 gregn3.npk 文件，如果有消息框弹出就选择‘是’。

gregn3.npk 文件存在于 Grid++Report 的安装目录下，如果 Grid++Report 安装在C:\Program Files\Grid++Report 3 目录下，则 NPK 文件位于 C:\Program Files\Grid++Report 3\Samples\易语言\NPK 目录下。

如果你是单独下载Grid++Report易语言例子程序包，NPK 文件存在于解包目录下的 NPK 子目录中。

4.安装 grdes3.npk 文件：重复上一步操作安装 grdes3.npk。

5.关闭当前窗口，完成 NPK 文件安装任务。

将 Grid++Report 类型库加入到支持库中：1.首先运行易语言。

2.首先运行‘易语言’选择‘工具’→‘支持库配置’菜单3.在打开的对话框中的列表中选中‘报表引擎库 1.0 版’与‘报表设计库 1.0 版’。

提示：这两个需要选中的项目文字前面有‘★’标志符号。

(注：易语言在此显示的版本为1.0，但Grid++Report 的实际版本不是，这里不清楚原因。

)4.执行对话框中的‘确定按钮’，关闭对话框。

此时在易语言主窗口的窗口组件箱的‘外部组件’栏目下会加入：‘GRDisplayViewer’、‘GRPrintViewer’与‘GRDesigner’这三个控件；在‘外部事件组件’栏目下会加入‘GridppReport事件’。