本文档阐述了可用的预览窗体种类,并说明了如何在这些窗体中显示报表文档。
本文档由下列小节组成。
打印预览的主要概念
在打印或导出 报表文档 之前,通常应该把它显示在一个允许最终用户预览文档、并指定打印或导出选项的特殊窗体中。 要这样做,则可以利用下面的两种窗体之一:
-
PrintPreviewFormEx 类表示的标准打印预览窗体。
它包含 PrintControl (在其中显示报表文档) 和 PrintBarManager 组件 (提供操作文档的工具栏)。 要获知细节,请参阅 打印预览元素。
-
PrintPreviewRibbonFormEx 类表示的流行的 Ribbon 打印预览 窗体。
更多信息,请参阅 打印预览 Ribbon 窗体。
可以使用这些窗体中的任何一个,要么使用默认窗体,要么定制它们,或者基于它们创建自定义预览窗体。 要获知细节,请参阅 定制标准的打印预览 和 创建自定义打印预览。
调用预览窗体
最起码,打印预览窗体允许最终用户预览报表文档、修改打印设置、打印报表、缩放、导航整个报表、修改边距和水印、执行内部搜索、以及导出为支持的文件格式。 下面的插图显示了标准的打印预览窗体。
要调用预览窗体,则调用下列方法之一:
- XtraReport.ShowPreview 方法,调用显示报表打印预览的预览窗体;
- XtraReport.ShowPreviewDialog 方法,调用 模态 显示报表打印预览的预览窗体。
每个方法都有 2 个重载,允许调用默认的、或者指定的外观与感觉设置的预览窗体。
注意 |
---|
如果在调用任何这些方法之前,报表文档没有被创建,那么会自动调用 XtraReport.CreateDocument 方法来创建。 |
关于使用这些方法的代码示例,请参阅 如何: 显示打印预览窗体。
注意 |
---|
可以接管在打印预览中触发的鼠标事件,来提供最终用户交互 (例如创建 drill-down 或 drill-through 报表)。 更多信息,请参阅 打印预览的鼠标事件。 |
要学习更多关于 PrintPreviewFormEx 类的内容,请参阅 XtraPrinting 帮助中 打印预览窗体 文档。
调用 Ribbon 预览窗体
要调用 Ribbon 预览窗体,则调用下列方法之一:
- XtraReport.ShowRibbonPreview 方法,调用显示报表打印预览的 Ribbon 预览窗体;
- XtraReport.ShowRibbonPreviewDialog 方法,调用模态显示报表打印预览的有指定的外观与感觉设置的预览窗体。
每个方法都有 2 个重载,允许调用默认的、或者指定的外观与感觉设置的 Ribbon 预览窗体。
注意 |
---|
如果在调用任何这些方法之前,报表文档没有被创建,那么会自动调用 XtraReport.CreateDocument 方法来创建。 |
关于使用这些方法的代码示例,请参阅 如何: 显示 Ribbon 打印预览窗体。
要学习更多关于 PrintPreviewRibbonFormEx 类的内容,请参阅 XtraPrinting 帮助中的 打印预览 Ribbon 窗体 文档。