本指南演示了如何在任意窗体上显示报表的预览。 要这样做,需要使用 PrintControl 控件。 要获得更多关于 XtraReports 中预览功能的信息,请参阅 打印预览 文档。
要在自定义窗体上预览报表,则执行下列操作。
-
启动 MS Visual Studio (2005、2008 或 2010),并且新建一个或者打开一个现有的 Windows 窗体应用程序。
-
添加新空白报表 到项目中。 后面,将在此窗体中预览报表。 注意,报表必须包含至少一个控件,以便于能够生成预览。 因此,把任意控件拖放到报表中,来预览所需的任何复杂报表。
注意 请参阅 报表构建基础 文档来学习更多关于创建报表的基本原则。
-
然后,切换到 Form1 的设计器。
把 PrintControl 项从工具箱中拖放到窗体上。 注意, 在默认情况下,PrintControl 被添加到了 Visual Studio IDE 的 DX.10.2: Reporting 工具箱标签页。
注意 可以把 PrintControl.Dock 属性设置为 Fill,从而让 PrintControl 对象占用整个窗体区域。
-
在本例中,当 Form1 被加载时,报表的预览被一次生成。 要这样做,则需要把下列代码添加到 Form1.Load 事件处理程序。
C# 复制代码 private void Form1_Load(object sender, EventArgs e) { // Create a report. XtraReport1 report = new XtraReport1(); // Bind the report's printing system to the print control. printControl1.PrintingSystem = report.PrintingSystem; // Generate the report's print document. report.CreateDocument(); }
Visual Basic 复制代码 Private Sub Form1_Load(sender As Object, e As EventArgs) _ Handles Form1.Load ' Create a report. Dim Report As New XtraReport1() ' Bind the report's printing system to the print control. PrintControl1.PrintingSystem = Report.PrintingSystem ' Generate the report's print document. Report.CreateDocument() End Sub
运行此应用程序。 被调用的窗体现在包含了报表预览。
注意,也可以使用 PrintControl 创建自己的自定义预览窗体。 更多信息,请参阅 如何: 创建自定义预览窗体 和 如何: 创建自定义 Ribbon 预览窗体 指南。