从版本 6.2 以上,XtraGrid 控件提供了新的导出方法。 这些方法使用在 XtraPrinting 库中实现的例程来导出数据。 本文档总结了关于新导出方法的信息。
导出方法
下表列出了可用的数据导出方法:
方法 | 说明 |
---|---|
BaseView.ExportToHtml , GridControl.ExportToHtml | 以 HTML 格式导出网格的数据。 |
BaseView.ExportToMht , GridControl.ExportToMht | 以 MHT 格式导出网格的数据。 |
BaseView.ExportToPdf , GridControl.ExportToPdf | 以 PDF 格式导出网格的数据。 |
BaseView.ExportToRtf , GridControl.ExportToRtf | 以 RTF 格式导出网格的数据。 |
BaseView.ExportToText , GridControl.ExportToText | 以 Text 格式导出网格的数据。 |
BaseView.ExportToXls , GridControl.ExportToXls | 以 XLS 格式导出网格的数据。 |
BaseView.ExportToXlsx , GridControl.ExportToXlsx | 以 XLSX (MS Excel 2007) 格式导出网格的数据。 |
注意 |
---|
这些导出方法使用 XtraPrinting 库导出数据。 如果该库不可用,则这些方法不执行操作。 |
注意,不能导出自定义绘制的结果。
可以看到,ExportTo... 方法在 GridControl 和 BaseView 类中是完全相同的。 由 GridControl 类提供的 ExportTo... 方法导出默认视图的数据 (默认视图是当前最大化的视图,通过 GridControl.DefaultView 属性引用; 请参阅 缩放视图 获得更多信息)。 由 BaseView 类提供的 ExportTo... 方法导出当前的 BaseView 实例的数据。
XtraGrid 控件不提供直接把数据导出为某些附加格式 (例如 BMP、PNG) 的方法,尽管 XtraPrinting 库可以支持这些格式。 使用由 XtraPrinting 库提供的方法,可以以该库支持的任何格式导出网格的数据。 请参阅 使用 XtraPrinting 库,将控件以不同格式(PDF、HTML、BMP 等)导出 来获得更多细节。 您也可能发现,在导出网格数据时,如果需要定制报告 (添加报表标头、脚注等),则使用由 XtraPrinting 库提供的方法。 请参阅 如何: 在打印/导出控件时设置纸张格式,并把定制信息添加到报告中 获得相关信息。
导出选项
使用网格控件的视图的 OptionsPrint 属性,可以访问和定制导出选项。 这些选项也控制如何打印网格的数据。
公共外观选项
在默认情况下,在导出输出中任何视图的外观设置都由视图的 Appearance 属性指定。 当导出视图时,要使用不同的外观设置,则把 GridOptionsPrint.UsePrintStyles 属性设置为 true。 在这种情况下,在默认情况下,使用预定义的灰度绘制方案导出视图。 要指定不同的打印外观设置,则使用视图的 AppearancePrint 属性。
网格视图及其子类对象的导出选项
网格视图、带区网格视图 和 高级带区网格视图 的默认导出选项如下所示:
- 所有分组行都被展开在输出文件中,因此所有数据记录,即使是那些隐藏在已折叠分组行中的数据记录,都被包含在输出中。 要禁用此功能,则使用 GridOptionsPrint.ExpandAllGroups 属性;
- 如果视图以呈现主表视图的 HTML 格式导出,在默认情况下,它的细节数据不包含在输出文件中。 要和主数据一起导出细节数据,则把 GridOptionsPrint.PrintDetails 属性设置为 true。 在默认情况下,只有当前打开的细节视图被导出。 如果需要展开并导出所有细节视图到输出文件中,则把 GridOptionsPrint.ExpandAllDetails 属性设置为 true。
- 当导出为 HTML、PDF、RTF 和 XLS 格式时,所有主视图和细节视图都被调整大小,以便于它们的宽度相称,并且视图的右边缘被对齐。 要禁用自动对齐功能,则使用 GridOptionsPrint.AutoWidth 属性。
- 在默认情况下,视图的列标头和带区标头都被导出,即使它们被隐藏。 在默认情况下,如果视图的脚注包含任何汇总信息,则它被导出,即使它被隐藏。 要在导出输出中隐藏这些元素,则使用 GridOptionsPrint.PrintHeader、BandedGridOptionsPrint.PrintBandHeader 和 GridOptionsPrint.PrintFooter 属性。
- 如果视图的分组脚注和筛选面板在 GridControl 中可视,被这些元素导出。 如果这些元素不可视,则不导出它们,即使相应的导出选项已经启用。 如果需要防止这些元素被导出,则使用 GridOptionsPrint.PrintGroupFooter、GridOptionsPrint.PrintFilterInfo 属性。
卡片视图的导出选项
卡片视图 的默认导出选项如下所示:
- 不拉伸卡片来适合视图导出的文档页面宽度。 要使卡片拉伸,则把 CardOptionsPrint.AutoHorzWidth 属性设置为 true。 在这种模式中,水平显示在页面中的卡片数目由 CardView.PrintMaximumCardColumns 属性指定。
- 卡片标题在导出输出中可视,即使它们在屏幕上被隐藏 (CardOptionsView.ShowCardCaption 属性值设置为 false)。 要在导出输出中隐藏标题,则使用 CardOptionsPrint.PrintCardCaption 属性。
- 在默认情况下,包含 null 值的字段被导出。 要隐藏这些字段,则把 CardOptionsPrint.PrintEmptyFields 属性设置为 false。
- 在默认情况下导出所有卡片。 把 CardOptionsPrint.PrintSelectedCardOnly 选项设置为 true 允许只导出获得焦点的卡片。