DevExpress Office File API控件日前正式發(fā)布了v24.1，新版本正式官宣支持Unix系統(tǒng)的打印、增強了可訪問性等，歡迎下載最新版組件體驗！

DevExpress技術(shù)交流群10：532598169      歡迎一起進群討論

基于Unix系統(tǒng)的打印

在這個版本(v24.1)中，官方為運行在基于Unix系統(tǒng)上的基于.NET Office File API驅(qū)動的應用程序增加了打印支持，現(xiàn)在可以在非Windows環(huán)境中打印條碼、Word、Excel和PDF文檔。

新版本創(chuàng)建了一組新的API，與 DevExpress.Drawing 庫中可用的DXPrinterSettings選項一起工作。

使用以下新方法在基于Unix的系統(tǒng)上打印文檔和條形碼：

C#

// DevExpress.XtraRichEdit.RichEditDocumentServer:
public void Print(DXPrinterSettings printerSettings, string printDocumentName);
public void Print(DXPrinterSettings printerSettings);

//DevExpress.Spreadsheet.Workbook:
public void Print(DXPrinterSettings printerSettings);
public void Print(DXPrinterSettings printerSettings, params string[] sheetNames);
public void Print(DXPrinterSettings printerSettings, IEnumerable<string> sheetNames);

//DevExpress.BarCodes.BarCode:
public void Print(DXPrinterSettings printerSettings);

對于DevExpress.Pdf.PdfDocumentProcessor類，您仍然需要調(diào)用當前的Print(PdfPrinterSettings printerSettings)方法。要修改打印設置，請使用新的PdfPrinterSettings.DXPrinterSettings選項如下：

C#

using DevExpress.Drawing.Printing;
using DevExpress.Pdf;

// Load a PDF file
PdfDocumentProcessor documentProcessor = new PdfDocumentProcessor();
documentProcessor.LoadDocument(@"..\..\Demo.pdf");

// Declare printer settings
PdfPrinterSettings pdfPrinterSettings = new PdfPrinterSettings();

// Specify CUPS printer settings
DXPrinterSettings dxPrinterSettings = pdfPrinterSettings.DXSettings;
dxPrinterSettings.Duplex = DXDuplexMode.DuplexLongEdge;
dxPrinterSettings.Copies = 3;

// Print the document
documentProcessor.Print(pdfPrinterSettings);

注意：對于基于Unix的系統(tǒng)，您需要單獨安裝libcups2包。

可訪問性增強

在將Word文檔導出為可訪問的PDF文件時，新版本擴展了對以下元素的可訪問性相關(guān)支持：

• 目錄標簽
• 元數(shù)據(jù)字段
• Alt文本處理
• 表格
• 浮動對象

使用Adobe Acrobat Pro和PDF Accessibility Checker 2024進行質(zhì)量控制，新版本的測試文檔成功地通過了PDF/UA兼容性和WCAG 2.1兼容性的驗證。

當您PdfUACompatibility選項時，與可訪問性相關(guān)的導出增強功能可以開箱即用：

C#

using System.IO;
using DevExpress.XtraRichEdit;
// ...
RichEditDocumentServer wordProcessor = new RichEditDocumentServer();
//...
using(FileStream stream =
new FileStream(resultFilePath, FileMode.Create, FileAccess.Write, FileShare.Read)) {
PdfExportOptions exportOptions = new PdfExportOptions();
exportOptions.PdfUACompatibility = PdfUACompatibility.PdfUA1;

wordProcessor.ExportToPdf(stream, exportOptions);
}

此外新版本還為Word Processing Shape和Spreadsheet Shape類添加了一個Decorative屬性，以將文檔圖形(圖片、形狀和圖表)標記為裝飾性的。裝飾性的形狀增加了視覺上的趣味，但它們不能提供信息。因此在生成可訪問文檔時，不需要為裝飾性對象指定Alt Text(有意義的描述)。

將文檔導出為SVG

新版本擴展了圖像導出引擎，現(xiàn)在在Barcode Generation API、Word Processing Document API和Spreadsheet Document API庫中支持SVG圖像。使用v24.1，您可以在Windows和非Windows環(huán)境中從條形碼、Word文檔頁面和Excel工作表/單元格范圍生成SVG圖像。

要從條形碼生成SVG圖像，需要創(chuàng)建BarCode類實例，根據(jù)需要修改設置，并使用DXImageFormat.Svg作為參數(shù)調(diào)用BarCode.Save方法。

C#

using (BarCode barCode = new BarCode()) {
barCode.Symbology = Symbology.QRCode;
barCode.BackColor = Color.White;
barCode.ForeColor = Color.Black;
barCode.RotationAngle = 0;
barCode.CodeBinaryData = Encoding.Default.GetBytes("https://www.devexpress.com/");
barCode.Options.QRCode.CompactionMode = QRCodeCompactionMode.Byte;
barCode.Options.QRCode.ErrorLevel = QRCodeErrorLevel.Q;
barCode.Options.QRCode.ShowCodeText = false;
barCode.DpiX = 72;
barCode.DpiY = 72;
barCode.Module = 2f;

barCode.Save("barcode.svg", DXImageFormat.Svg);
}

對于Word文檔，使用全新的Image Export API - 創(chuàng)建一個RichEditImageExportOptions實例，使用RichEditImageExportOptions.Format屬性指定目標DXImageFormat.Svg格式，并使用RichEditImageExportOptions對象作為參數(shù)調(diào)用RichEditDocumentServerExtensions.ExportToImage擴展方法。

C#

using (var wordProcessor = new RichEditDocumentServer()) {
wordProcessor.LoadDocument(@"C:\Documents\Alice.docx");
RichEditImageExportOptions options = new RichEditImageExportOptions();
options.Format = DXImageFormat.Svg;
options.PageRange = "1";

wordProcessor.Document.ExportToImage("first_page_image.svg", options);
}

要將Excel工作表中的單元格區(qū)域?qū)С鰹镾VG圖像，請使用ImageFileFormat.Svg作為參數(shù)調(diào)用CellRangeExtensions.ExportToImage方法。

C#

using (Workbook workbook = new Workbook()) {
workbook.LoadDocument("InvestmentPortfolio.xlsx", DevExpress.Spreadsheet.DocumentFormat.Xlsx);
Worksheet worksheet = workbook.Worksheets.ActiveWorksheet;

worksheet.Range["B18:I30"].ExportToImage("cell_range_image.svg", ImageFileFormat.Svg);
}

Spreadsheet Document API

對齊和分布式文本對齊

v24.1增加了對電子表格單元格內(nèi)的水平對齊類型的支持，使用這些對齊選項的Excel文件可以打印并導出為PDF。

可以使Cell.Alignment.Horizontal 屬性在代碼中指定水平對齊方式。

下面的代碼片段指定了代碼中的對齊方式：

C#

var workbook = new Workbook();
var worksheet = workbook.Worksheets[0];

Cell cellA1 = worksheet.Cells["A1"];
cellA1.Value = "Justified and top";
cellA1.Alignment.Horizontal = SpreadsheetHorizontalAlignment.Justify;
cellA1.Alignment.Vertical = SpreadsheetVerticalAlignment.Top;
workbook.ExportToPdf("Result.pdf");