Previous topicNext topic
Help > 开发指南 > Excel > API > 示例 > Worksheet >
如何：设置纸张大小

电子表格文档 API 允许您指定打印工作表的纸张大小。将 PaperKind 枚举成员分配给 Worksheet.ActiveView.PaperKind  属性，以使用标准纸张大小之一（Letter、Legal、Tabloid 等）。

以下示例指定第一个工作表的纸张大小：

Vb.Net 
'创建一个Workbook工作簿对象.
Using workbook As New DevExpress.Spreadsheet.Workbook()
    '设置纸张大小.
    workbook.Worksheets(0).ActiveView.PaperKind = DevExpress.Drawing.Printing.DXPaperKind.Letter
End Using

C#
// 创建一个Workbook工作簿对象.
using (DevExpress.Spreadsheet.Workbook workbook = new DevExpress.Spreadsheet.Workbook())
{
    // 设置纸张大小.
    workbook.Worksheets[0].ActiveView.PaperKind = DevExpress.Drawing.Printing.DXPaperKind.Letter;
}

自定义纸张尺寸

调用 Worksheet.ActiveView.SetCustomPaperSize 方法以指定打印页面的自定义大小。使用 Workbook.Unit 属性指定纸张大小（宽度和高度）的度量单位。

以下示例指定第一个工作表的自定义纸张大小，并将文档导出为 PDF：

Vb.Net 
Using workbook As New DevExpress.Spreadsheet.Workbook()
    workbook.LoadDocument("D:\Document.xlsx", DevExpress.Spreadsheet.DocumentFormat.Xlsx)

    '将测量单位设置为英寸
    workbook.Unit = DevExpress.Office.DocumentUnit.Inch

    ' 指定自定义图纸尺寸（10英寸乘12英寸）。
    workbook.Worksheets(0).ActiveView.SetCustomPaperSize(10, 12)

    workbook.ExportToPdf("D:\PdfDocument.pdf")
End Using

C#
// 创建一个Workbook工作簿对象.
using (DevExpress.Spreadsheet.Workbook workbook = new DevExpress.Spreadsheet.Workbook())
{
    workbook.LoadDocument(@"D:\Document.xlsx", DevExpress.Spreadsheet.DocumentFormat.Xlsx);

    // 将测量单位设置为英寸
    workbook.Unit = DevExpress.Office.DocumentUnit.Inch;

    // 指定自定义图纸尺寸（10英寸乘12英寸）。
    workbook.Worksheets[0].ActiveView.SetCustomPaperSize(10, 12);

    workbook.ExportToPdf(@"D:\PdfDocument.pdf");
}

下图演示了结果：


仅当将工作簿导出为 Microsoft Office Open XML 格式（XLSX、XLSM、XLTX 和 XLTM）时，自定义纸张尺寸才会保存到文件中。当您在 Microsoft® Excel® 中打开并重新保存文档时，自定义大小值将丢失。