打印自定義報(bào)表

---

立即下載DevExpress WPF

 DXPrinting Library提供了一種創(chuàng)建自定義打印報(bào)表的簡單方法，這種方法是基于稱為打印鏈接的特殊打印程序。DXPrinting Library引入了幾種類型的 printing links，每種鏈接都是為呈現(xiàn)特定的數(shù)據(jù)對(duì)象、創(chuàng)建報(bào)表以及導(dǎo)出和打印報(bào)表而設(shè)計(jì)的，可以通過從LinkBase抽象類繼承您的類來創(chuàng)建自定義打印鏈接。

下表列出了內(nèi)置的打印鏈接類型。

打印鏈接	描述
SimpleLink	呈現(xiàn)包含線性數(shù)據(jù)的數(shù)據(jù)對(duì)象。
CollectionViewLink	呈現(xiàn)包含分層數(shù)據(jù)的數(shù)據(jù)對(duì)象，并實(shí)現(xiàn)ICollectionView 接口。
PrintableControlLink	DevExpress呈現(xiàn)控件。

創(chuàng)建簡單鏈接

簡單的打印鏈接通常用于在報(bào)表中顯示非分層數(shù)據(jù)，在不需要將數(shù)據(jù)項(xiàng)分成組的情況下使用這種鏈接。

 創(chuàng)建后，必須為簡單鏈接提供數(shù)據(jù)。要做到這一點(diǎn)，通過SimpleLink.DetailCount屬性指定數(shù)據(jù)項(xiàng)的數(shù)量，并處理SimpleLink.CreateDetail事件，每次需要新的數(shù)據(jù)項(xiàng)時(shí)都會(huì)引發(fā)該事件，并根據(jù)SimpleLink.DetailCount屬性指定的次數(shù)引發(fā)該事件，在處理程序中，將新的數(shù)據(jù)項(xiàng)分配給CreateAreaEventArgs.Data事件參數(shù)的屬性，所需數(shù)據(jù)項(xiàng)的索引可以使用CreateAreaEventArgs.DetailIndex屬性獲得。

 除了數(shù)據(jù)項(xiàng)之外，還必須指定可視化表示。要做到這一點(diǎn)，創(chuàng)建一個(gè) ，它應(yīng)該應(yīng)用于每個(gè)數(shù)據(jù)項(xiàng)，然后將其分配給鏈接的SimpleLink.DetailTemplate屬性。

創(chuàng)建集合視圖鏈接

 當(dāng)您需要在報(bào)表中顯示來自分層數(shù)據(jù)源的數(shù)據(jù)，或者當(dāng)數(shù)據(jù)項(xiàng)應(yīng)該分成幾個(gè)組顯示時(shí)，集合視圖打印鏈接非常有用。

 要將數(shù)據(jù)分配給集合視圖鏈接，需要?jiǎng)?chuàng)建一個(gè)實(shí)現(xiàn)ICollectionView接口的對(duì)象，它可以是System.Windows.Data.CollectionViewSource對(duì)象，向該對(duì)象提供數(shù)據(jù)后，將其分配給鏈接的CollectionViewLink.CollectionView屬性。

 當(dāng)指定數(shù)據(jù)時(shí)，您應(yīng)該定義其可視化表示。要做到這一點(diǎn)，創(chuàng)建一個(gè)DataTemplate應(yīng)該應(yīng)用于每個(gè)數(shù)據(jù)項(xiàng)，并將其分配給鏈接的CollectionViewLink.DetailTemplate屬性。為了提供關(guān)于分組信息的鏈接，為每個(gè)分組級(jí)別創(chuàng)建一個(gè)GroupInfo對(duì)象，并通過GroupInfo.HeaderTemplate屬性指定一個(gè)應(yīng)該應(yīng)用于當(dāng)前分組級(jí)別中的每個(gè)組頭的模板,然后將GroupInfo對(duì)象添加到鏈接的CollectionViewLink.GroupInfos 集合中。

創(chuàng)建可打印控件鏈接

 可打印控件鏈接用于呈現(xiàn)控件和實(shí)現(xiàn)IPrintableControl或IRootDataNode接口的數(shù)據(jù)對(duì)象。例如，TableView對(duì)象可以通過可打印控件鏈接呈現(xiàn)。

 要?jiǎng)?chuàng)建一個(gè)可打印的控件鏈接，將適當(dāng)?shù)目丶驍?shù)據(jù)對(duì)象傳遞給PrintableControlLink構(gòu)造函數(shù)。

頁面設(shè)置

DXPrinting Library提供了許多設(shè)置，允許自定義報(bào)表的頁面選項(xiàng)。

 您可以在報(bào)表中包含頁眉和頁腳，以及整個(gè)文檔的頁眉和頁腳。要做到這一點(diǎn)，分別通過TemplatedLink.PageHeaderTemplate、TemplatedLink.PageFooterTemplate、TemplatedLink.ReportHeaderTemplate和TemplatedLink.ReportFooterTemplate 屬性指定它們的模板。通過將適當(dāng)?shù)臄?shù)據(jù)對(duì)象分別分配給TemplatedLink.PageHeaderData、TemplatedLink.PageFooterData、TemplatedLink.ReportHeaderData和TemplatedLink.ReportFooterData屬性，這些模板也可以提供一些自定義數(shù)據(jù)。

下表列出了用于指定報(bào)表頁設(shè)置的其他屬性。

屬性	描述
LinkBase.CustomPaperSize	獲取或設(shè)置自定義紙張的大小(以百分之一英寸為單位測量)。
LinkBase.DocumentName	獲取或設(shè)置文檔的名稱。
LinkBase.Landscape	獲取或設(shè)置一個(gè)值，該值指示頁面方向是否為橫向。
LinkBase.Margins	獲取或設(shè)置報(bào)表頁面的邊距（以百分之一英寸為單位測量）。
LinkBase.MinMargins	指定最小打印機(jī)邊距值。
LinkBase.PaperKind	獲取或設(shè)置文檔的紙張類型。
LinkBase.SuppressAutoRebuildOnPageSettingsChange	獲取或設(shè)置一個(gè)值，該值指示是否有必要在每次更改鏈接的頁面設(shè)置時(shí)禁止重建文檔。

導(dǎo)出和打印報(bào)表

 在創(chuàng)建鏈接對(duì)象并提供數(shù)據(jù)之后，您可以通過調(diào)用LinkBase.CreateDocument方法從鏈接創(chuàng)建文檔，現(xiàn)在報(bào)表生成了就可以打印和導(dǎo)出它，也可以在DocumentPreview控件中顯示它。要做到這一點(diǎn)，有必要?jiǎng)?chuàng)建一個(gè)新的LinkPreviewModel實(shí)例，將當(dāng)前鏈接作為初始化參數(shù)，并將其分配給DocumentPreview.Model屬性。

 使用LinkBase.ShowPrintPreview方法可打開報(bào)表預(yù)覽窗口。要打開一個(gè)模式預(yù)覽窗口，使用LinkBase.ShowPrintPreviewDialog方法，打印對(duì)話框可以通過LinkBase.Print方法調(diào)用，要在不打開任何對(duì)話框的情況下打印報(bào)告，請(qǐng)使用LinkBase.PrintDirect方法。

下表列出了用于將報(bào)表導(dǎo)出為不同格式的方法。

方法	描述
LinkBase.ExportToCsv	使用指定的CSV特定選項(xiàng)，用CSV格式將報(bào)表導(dǎo)出到指定的流。
LinkBase.ExportToHtml	使用指定的特定于HTML的選項(xiàng)，用HTML格式將報(bào)告導(dǎo)出到指定的流。
LinkBase.ExportToImage
LinkBase.ExportToMht	使用指定的MHT特定選項(xiàng)用MHT格式將報(bào)告導(dǎo)出到指定流。
LinkBase.ExportToPdf	使用指定的PDF特定選項(xiàng)用PDF格式將報(bào)表導(dǎo)出到指定的流。
LinkBase.ExportToRtf	使用指定的RTF特定選項(xiàng)用RTF格式將報(bào)表導(dǎo)出到指定的流。
LinkBase.ExportToText	使用指定的特定于文本的選項(xiàng)用文本格式將報(bào)表導(dǎo)出到指定的流。
LinkBase.ExportToXls	使用指定的特定于XLS的選項(xiàng)用XLS格式將報(bào)告導(dǎo)出到指定的流。
LinkBase.ExportToXlsx	使用指定的特定于XLSX的選項(xiàng)，用XLSX格式將報(bào)告導(dǎo)出到指定的流。
LinkBase.ExportToXps	使用指定的特定于XPS的選項(xiàng)用XPS格式將報(bào)表導(dǎo)出到指定的流。