使用二次封装的Excel COM 组件操作Excel\WPS ET 页面设置和打印预览-CSDN博客

本文链接：https://blog.csdn.net/xlqdml/article/details/150959106

本文档适用于需要在 Excel 工作表中进行页面设置和打印预览操作的开发者，解决以下问题：

如何配置页面方向、纸张大小和缩放比例
如何设置页边距和居中方式
如何自定义页眉页脚内容
如何配置打印选项和区域
如何进行打印预览和打印操作
如何简化复杂的页面布局和打印任务

页面设置和打印预览是Excel文档处理中非常重要的环节，特别是在生成报表、制作文档模板以及批量处理Excel文件时。通过使用MudTools.OfficeInterop库提供的接口，开发者可以自动化这些原本需要手动操作的任务，大大提高工作效率。

IExcelPageSetup - 页面设置操作接口

IExcelPageSetup 用于管理 Excel 工作表的页面设置。这个接口提供了对Excel工作表页面布局的全面控制，涵盖了从基本的页面方向到复杂的页眉页脚设置等各个方面。

页面设置是打印Excel工作表前的重要步骤，它决定了文档在纸张上的布局和外观。通过IExcelPageSetup接口，开发者可以精确控制每个打印参数，确保输出文档符合预期的格式要求。

页面设置基础操作

页面设置基础操作包括配置页面方向、纸张大小、缩放比例等核心属性，这些设置直接影响文档在打印时的外观和布局。

// 获取或设置页面方向（纵向或横向）
XlPageOrientation orientation = pageSetup.Orientation;
pageSetup.Orientation = XlPageOrientation.xlLandscape;

// 获取或设置纸张大小
XlPaperSize paperSize = pageSetup.PaperSize;
pageSetup.PaperSize = XlPaperSize.xlPaperA4;

// 获取或设置页面缩放比例（10-400）
int zoom = pageSetup.Zoom;
pageSetup.Zoom = 100;

// 获取或设置是否适合页面宽度
int fitToPagesWide = pageSetup.FitToPagesWide;
pageSetup.FitToPagesWide = 1;

// 获取或设置是否适合页面高度
int fitToPagesTall = pageSetup.FitToPagesTall;
pageSetup.FitToPagesTall = 1;

页面方向设置决定了工作表内容在纸张上的排列方式。纵向（xlPortrait）是默认设置，适合大多数文档；横向（xlLandscape）适合宽表格数据，可以容纳更多列信息。

纸张大小设置允许选择不同标准的纸张格式，如A4、Letter、Legal等，确保文档在不同地区和用途中正确打印。

缩放比例控制打印时内容的大小，可以设置为固定百分比或使用FitToPages属性自动调整以适应指定的页数。

页边距设置操作

页边距设置决定了内容与纸张边缘的距离，适当的页边距设置可以确保文档打印时不会因为打印机的物理限制而丢失内容。

// 获取或设置左边距（英寸）
double leftMargin = pageSetup.LeftMargin;
pageSetup.LeftMargin = 0.5;

// 获取或设置右边距（英寸）
double rightMargin = pageSetup.RightMargin;
pageSetup.RightMargin = 0.5;

// 获取或设置上边距（英寸）
double topMargin = pageSetup.TopMargin;
pageSetup.TopMargin = 0.75;

// 获取或设置下边距（英寸）
double bottomMargin = pageSetup.BottomMargin;
pageSetup.BottomMargin = 0.75;

// 获取或设置页眉边距（英寸）
double headerMargin = pageSetup.HeaderMargin;
pageSetup.HeaderMargin = 0.3;

// 获取或设置页脚边距（英寸）
double footerMargin = pageSetup.FooterMargin;
pageSetup.FooterMargin = 0.3;

// 获取或设置居中方式（水平居中）
bool centerHorizontally = pageSetup.CenterHorizontally;
pageSetup.CenterHorizontally = true;

// 获取或设置居中方式（垂直居中）
bool centerVertically = pageSetup.CenterVertically;
pageSetup.CenterVertically = true;

页边距以英寸为单位进行设置，合理的页边距可以确保内容不会被裁剪，同时充分利用纸张空间。居中设置可以将内容在页面中居中显示，使文档更加美观。

页眉页脚设置操作

页眉页脚是文档的重要组成部分，可以包含页码、文档标题、日期等信息，为文档提供专业外观。

// 获取或设置左页眉内容
string leftHeader = pageSetup.LeftHeader;
pageSetup.LeftHeader = "公司名称";

// 获取或设置中页眉内容
string centerHeader = pageSetup.CenterHeader;
pageSetup.CenterHeader = "报告标题";

// 获取或设置右页眉内容
string rightHeader = pageSetup.RightHeader;
pageSetup.RightHeader = "机密";

// 获取或设置左页脚内容
string leftFooter = pageSetup.LeftFooter;
pageSetup.LeftFooter = "作者：张三";

// 获取或设置中页脚内容
string centerFooter = pageSetup.CenterFooter;
pageSetup.CenterFooter = "部门：销售部";

// 获取或设置右页脚内容
string rightFooter = pageSetup.RightFooter;
pageSetup.RightFooter = "第 &P 页，共 &N 页";

页眉页脚支持特殊代码，如&P（当前页码）、&N（总页数）、&D（当前日期）等，可以动态显示相关信息。通过合理设置页眉页脚，可以为文档添加专业标识和导航信息。

打印选项设置

打印选项设置允许控制打印时的各种细节，如网格线、标题行、打印区域等，这些选项直接影响打印输出的效果。

// 获取或设置打印顺序
XlOrder order = pageSetup.Order;
pageSetup.Order = XlOrder.xlDownThenOver;

// 获取或设置是否以草稿模式打印
bool draft = pageSetup.Draft;
pageSetup.Draft = false;

// 获取或设置是否打印网格线
bool printGridlines = pageSetup.PrintGridlines;
pageSetup.PrintGridlines = true;

// 获取或设置是否打印行列标题
bool printHeadings = pageSetup.PrintHeadings;
pageSetup.PrintHeadings = true;

// 获取或设置打印标题行
string printTitleRows = pageSetup.PrintTitleRows;
pageSetup.PrintTitleRows = "$1:$1";

// 获取或设置打印标题列
string printTitleColumns = pageSetup.PrintTitleColumns;
pageSetup.PrintTitleColumns = "$A:$A";

// 获取或设置打印区域
string printArea = pageSetup.PrintArea;
pageSetup.PrintArea = "$A$1:$E$20";

// 获取或设置是否从第一页开始编号
int firstPageNumber = pageSetup.FirstPageNumber;
pageSetup.FirstPageNumber = 1;

打印选项提供了精细的控制能力，可以指定仅打印特定区域、重复打印标题行以增强可读性、控制打印质量等。

页面设置操作方法

除了属性设置外，IExcelPageSetup还提供了一些实用的方法来简化操作流程。

// 应用页面设置
pageSetup.Apply();

// 重置页面设置为默认值
pageSetup.Reset();

// 复制页面设置
pageSetup.Copy(sourcePageSetup);

// 设置自定义页眉页脚
pageSetup.SetCustomHeaderFooter(1, 1, "自定义页眉内容");

Apply方法用于将设置应用到工作表，Reset方法可以快速恢复默认设置，Copy方法可以从其他工作表复制页面设置，SetCustomHeaderFooter方法提供了设置页眉页脚的另一种方式。

IExcelPrintPreview - 打印预览操作接口

IExcelPrintPreview 用于管理 Excel 工作表的打印预览功能。这个接口允许开发者在不实际打印的情况下查看文档的打印效果，并提供了导出为PDF等实用功能。

打印预览是确保文档打印效果符合预期的重要步骤。通过IExcelPrintPreview接口，开发者可以程序化地查看、调整和导出打印效果，避免浪费纸张和墨水。

打印预览基础操作

打印预览基础操作包括控制预览窗口的显示效果，如缩放比例、网格线显示等。

// 获取或设置打印预览的缩放比例（10-400）
int zoom = printPreview.Zoom;
printPreview.Zoom = 100;

// 获取或设置是否显示页眉
bool showHeaders = printPreview.ShowHeaders;
printPreview.ShowHeaders = true;

// 获取或设置是否显示页脚
bool showFooters = printPreview.ShowFooters;
printPreview.ShowFooters = true;

// 获取或设置是否显示网格线
bool showGridlines = printPreview.ShowGridlines;
printPreview.ShowGridlines = true;

// 获取或设置是否显示行列标题
bool showHeadings = printPreview.ShowHeadings;
printPreview.ShowHeadings = true;

通过这些设置，开发者可以控制预览时的显示效果，确保所有必要的元素都正确显示。

打印预览页面设置

打印预览中的页面设置允许在预览时调整页面布局，而无需返回到页面设置界面。

// 获取或设置页面方向（纵向或横向）
int orientation = printPreview.Orientation;
printPreview.Orientation = 2; // 横向

// 获取或设置纸张大小
int paperSize = printPreview.PaperSize;
printPreview.PaperSize = 9; // A4

// 获取或设置页边距（英寸）
double leftMargin = printPreview.LeftMargin;
printPreview.LeftMargin = 0.5;

double rightMargin = printPreview.RightMargin;
printPreview.RightMargin = 0.5;

double topMargin = printPreview.TopMargin;
printPreview.TopMargin = 0.75;

double bottomMargin = printPreview.BottomMargin;
printPreview.BottomMargin = 0.75;

这些设置使得开发者可以在预览过程中快速调整页面布局，实时查看效果。

打印预览页眉页脚设置

页眉页脚在打印预览中同样重要，可以预览实际打印效果。

// 获取或设置页眉内容
string leftHeader = printPreview.LeftHeader;
printPreview.LeftHeader = "公司名称";

string centerHeader = printPreview.CenterHeader;
printPreview.CenterHeader = "报告标题";

string rightHeader = printPreview.RightHeader;
printPreview.RightHeader = "机密";

// 获取或设置页脚内容
string leftFooter = printPreview.LeftFooter;
printPreview.LeftFooter = "作者：张三";

string centerFooter = printPreview.CenterFooter;
printPreview.CenterFooter = "部门：销售部";

string rightFooter = printPreview.RightFooter;
printPreview.RightFooter = "第 &P 页，共 &N 页";

通过预览页眉页脚，可以确保特殊代码（如页码）正确解析和显示。

打印预览操作方法

IExcelPrintPreview接口提供了多种操作方法来控制预览过程。

// 显示打印预览窗口
printPreview.Show();

// 刷新打印预览显示
printPreview.Refresh();

// 打印当前预览的内容
printPreview.Print(2, true); // 打印2份，逐份打印

// 导出预览为PDF文件
printPreview.ExportToPDF(@"C:\Reports\Report.pdf");

Show方法显示预览窗口，Refresh方法更新预览显示，Print方法直接打印文档，ExportToPDF方法将文档导出为PDF格式，这在无纸化办公环境中非常有用。

实际应用示例

配置工作表页面设置

// 配置工作表页面设置
using var excelApp = ExcelFactory.BlankWorkbook();
var workbook = excelApp.ActiveWorkbook;
var worksheet = excelApp.GetActiveSheet();

try
{
    // 填充一些示例数据
    worksheet.Cells[1, 1].Value = "产品销售报告";
    worksheet.Cells[2, 1].Value = "产品名称";
    worksheet.Cells[2, 2].Value = "销售数量";
    worksheet.Cells[2, 3].Value = "销售额";
    
    for (int i = 3; i <= 20; i++)
    {
        worksheet.Cells[i, 1].Value = $"产品{i-2}";
        worksheet.Cells[i, 2].Value = new Random().Next(100, 1000);
        worksheet.Cells[i, 3].Value = new Random().Next(1000, 10000);
    }
    
    // 获取页面设置对象
    var pageSetup = worksheet.PageSetup;
    
    // 设置页面方向为横向
    pageSetup.Orientation = XlPageOrientation.xlLandscape;
    
    // 设置纸张大小为A4
    pageSetup.PaperSize = XlPaperSize.xlPaperA4;
    
    // 设置缩放为100%
    pageSetup.Zoom = 100;
    
    // 设置页边距
    pageSetup.LeftMargin = 0.5;
    pageSetup.RightMargin = 0.5;
    pageSetup.TopMargin = 0.75;
    pageSetup.BottomMargin = 0.75;
    
    // 设置居中方式
    pageSetup.CenterHorizontally = true;
    pageSetup.CenterVertically = false;
    
    // 设置页眉页脚
    pageSetup.LeftHeader = "公司名称";
    pageSetup.CenterHeader = "产品销售报告";
    pageSetup.RightHeader = DateTime.Now.ToString("yyyy-MM-dd");
    pageSetup.CenterFooter = "第 &P 页，共 &N 页";
    
    // 设置打印选项
    pageSetup.PrintGridlines = true;
    pageSetup.PrintHeadings = true;
    pageSetup.PrintTitleRows = "$2:$2"; // 打印标题行
    
    // 应用设置
    pageSetup.Apply();
    
    // 保存文件
    workbook.SaveAs(@"C:\Reports\SalesReport.xlsx");
}
finally
{
    excelApp.Quit();
}

这个示例展示了如何创建一个包含销售数据的工作表，并配置专业的页面设置，包括横向布局、适当的页边距、页眉页脚等。

使用打印预览功能

// 使用打印预览功能
using var excelApp = ExcelFactory.Open(@"C:\Reports\SalesReport.xlsx");
var workbook = excelApp.ActiveWorkbook;
var worksheet = excelApp.GetActiveSheet();

try
{
    // 获取打印预览对象
    var printPreview = worksheet.PrintPreview;
    
    // 配置打印预览设置
    printPreview.Zoom = 80;
    printPreview.ShowGridlines = true;
    printPreview.ShowHeadings = true;
    printPreview.LeftHeader = "公司名称";
    printPreview.CenterHeader = "产品销售报告";
    printPreview.RightHeader = DateTime.Now.ToString("yyyy-MM-dd");
    printPreview.CenterFooter = "第 &P 页，共 &N 页";
    
    // 显示打印预览
    printPreview.Show();
    
    // 用户在预览窗口中可以查看效果，确认无误后可以打印
    // printPreview.Print(1, true);
}
finally
{
    excelApp.Quit();
}

此示例演示了如何打开现有工作表并使用打印预览功能，在实际打印前检查效果。

批量处理工作表页面设置

// 批量处理工作表页面设置
using var excelApp = ExcelFactory.Open(@"C:\Reports\AnnualReport.xlsx");
var workbook = excelApp.ActiveWorkbook;

try
{
    // 遍历所有工作表并设置统一的页面配置
    foreach (var worksheet in workbook.Worksheets)
    {
        var pageSetup = worksheet.PageSetup;
        
        // 统一设置页面方向
        pageSetup.Orientation = XlPageOrientation.xlPortrait;
        
        // 统一设置纸张大小
        pageSetup.PaperSize = XlPaperSize.xlPaperA4;
        
        // 统一设置页边距
        pageSetup.LeftMargin = 0.75;
        pageSetup.RightMargin = 0.75;
        pageSetup.TopMargin = 1.0;
        pageSetup.BottomMargin = 1.0;
        
        // 统一设置页眉页脚
        pageSetup.CenterHeader = workbook.Name;
        pageSetup.CenterFooter = "第 &P 页";
        
        // 统一设置打印选项
        pageSetup.PrintGridlines = false;
        pageSetup.CenterHorizontally = true;
        
        // 应用设置
        pageSetup.Apply();
    }
    
    // 保存文件
    workbook.Save();
}
finally
{
    excelApp.Quit();
}

这个示例展示了如何批量处理多个工作表的页面设置，确保整个工作簿的打印格式统一。

性能优化建议

批量页面设置操作

// 在操作大量页面设置时禁用屏幕更新
excelApp.ScreenUpdating = false;

try
{
    // 批量操作页面设置
    foreach (var worksheet in workbook.Worksheets)
    {
        var pageSetup = worksheet.PageSetup;
        pageSetup.Orientation = XlPageOrientation.xlLandscape;
        pageSetup.PaperSize = XlPaperSize.xlPaperA4;
        pageSetup.Zoom = 100;
        pageSetup.Apply();
    }
}
finally
{
    excelApp.ScreenUpdating = true;
}

在处理大量工作表时，禁用屏幕更新可以显著提高性能，避免界面刷新带来的开销。

打印预览性能优化

// 在执行打印预览操作时优化性能
excelApp.ScreenUpdating = false;

try
{
    // 执行打印预览相关操作
    var printPreview = worksheet.PrintPreview;
    printPreview.Refresh();
}
finally
{
    excelApp.ScreenUpdating = true;
}

类似地，在执行打印预览操作时也应考虑性能优化，特别是在处理复杂工作表时。

最佳实践

错误处理

try
{
    // 操作页面设置
    var pageSetup = worksheet.PageSetup;
    pageSetup.Orientation = XlPageOrientation.xlLandscape;
    pageSetup.Apply();
}
catch (Exception ex)
{
    // 处理异常
    Console.WriteLine($"页面设置操作失败: {ex.Message}");
}

在操作页面设置时，应始终包含适当的错误处理机制，以应对可能出现的异常情况。

资源管理

// 使用 using 语句确保资源正确释放
using var excelApp = ExcelFactory.BlankWorkbook();
try
{
    var workbook = excelApp.ActiveWorkbook;
    var worksheet = excelApp.GetActiveSheet();
    
    // 执行页面设置和打印预览操作
    ProcessPageSetupAndPreview(worksheet);
    
    // 保存工作簿
    workbook.SaveAs(@"C:\Reports\ProcessedReport.xlsx");
}
finally
{
    excelApp.Quit();
}