使用 Python 在 Excel 中插入和自定义页眉和页脚

摘要：本文探讨了如何使用 Python 在 Excel 中插入和自定义页眉和页脚。主题包括插入基本页眉和页脚、在页眉和页脚中添加图像、为奇数页和偶数页创建不同的页眉和页脚，以及为第一页定义唯一的页眉和页脚。

本文探讨了如何使用 Python 在 Excel 中插入和自定义页眉和页脚。主题包括插入基本页眉和页脚、在页眉和页脚中添加图像、为奇数页和偶数页创建不同的页眉和页脚，以及为第一页定义唯一的页眉和页脚。

Excel 中的页眉和页脚是您可以放置内容的区域，这些内容将显示在工作表的每个打印页面上。此内容在常规 Excel 工作视图中不可见，但仅在您处于页面布局视图或打印文档时可见。它们旨在使打印报告更具信息性和专业性。

页眉：显示在每个打印页面顶部的文本或图像。常见的标题元素包括文档标题、公司名称或日期。页脚：显示在每个打印页面底部的文本或图像。典型的页脚元素包括页码、文件路径或作者姓名。

为了在 Python 的 Excel 中插入页眉和页脚，本博客使用了一个名为 Spire.XLS for Python 的第三方库。

Spire.XLS for Python 是一个 Excel 库，用于在 Python 应用程序中创建、读取、编辑和转换 Excel 文件。该库与许多电子表格格式兼容，包括 XLS、XLSX、XLSB、XLSM、ODS 等。此外，它还提供了将 Excel 文件转换为其他文件格式的能力，例如 PDF、HTML、CSV、文本、图像、XML、SVG、ODS、PostScript 和 XPS。

您可以通过在终端窗口中运行以下命令从 PyPI 安装 Spire.XLS for Python：

pip install Spire.Xls

有关安装的更多详细信息，请查看此官方文档：如何在 VS Code 中安装 Spire.XLS for Python。

在 Excel 中，页眉和页脚通常分为三个部分：左、中和右：

在 Spire.XLS for Python 中，这些页眉和页脚部分由 PageSetup 类中的特定属性表示。这些属性包括：

左标头中心标题右标题左脚CenterFooter （中心页脚）右脚

使用这些属性，您可以轻松地将内容添加到页眉和页脚的特定部分。此外，Spire.XLS 还允许您插入特殊代码作为页眉和页脚属性的一部分，以自定义页眉和页脚的外观和内容，例如：

&P：插入当前页码。&N：插入总页数。&G：插入图像。&D：插入当前日期。&T：插入当前时间。&“fontname”：指定以下文本的自定义字体。&nn：指定以下文本的字体大小（两位数）。还有很多。

以下步骤说明如何使用 Spire.XLS for Python 在 Python 的 Excel 工作表中插入页眉和页脚：

打开 Excel 文件：初始化 Workbook 类的实例，并使用 workbook.LoadFromFile 方法加载现有 Excel 文件。选择工作表：选择要在其中插入页眉和页脚的特定工作表。将内容添加到页眉和页脚：
- 使用 Worksheet.PageSetup.LeftHeader 属性设置标题左侧部分的内容。
- 使用 Worksheet.PageSetup.CenterFooter 属性设置页脚中心部分的内容。更改视图模式：切换到“页面布局视图”以预览页眉和页脚。保存文件：使用 Workbook.SaveToFile 方法保存修改后的 Excel 文件。

以下代码显示了如何在 Python 中将带有文本内容的页眉和页脚插入 Excel 工作表中：

from spire.xls import *# Open an Excel workbookworkbook = Workbookworkbook.LoadFromFile("Sales.xlsx")# Get the first worksheetsheet = workbook.Worksheets[0]# Add text to the left section of the header. sheet.PageSetup.LeftHeader = "&\"Arial\"&14&K808080 ABC Corporation"# Add page number and total number of pages to the center section of the footer.sheet.PageSetup.CenterFooter = "&K808080 Page &P of &N"# Change the view mode of the worksheet to the page layout viewsheet.ViewMode = ViewMode.Layout# Save the modified fileworkbook.SaveToFile("InsertHeaderAndFooter.xlsx", ExcelVersion.Version2016)workbook.Dispose

解释：

&“Arial”&14：将字体设置为 Arial，将字体大小设置为 14。&K808080：使用 RGB 十六进制颜色代码 808080 将颜色设置为灰色。ABCCorporation：这是标题中显示的实际文本。页数&P共N 页：显示文本“第 X 页，共 Y 页”，其中 X 是当前页码，Y 是总页数。

如果灰色不是您想要的颜色，请确保调整 RGB 颜色代码以匹配所需的颜色。例如，FF0000 为红色，00FF00 为绿色，0000FF 为蓝色。

除了文本之外，您还可以将图像添加到页眉和页脚。这对于在文档中包含徽标、水印或任何其他图形元素非常有用。

如上一主题所示，您可以在页眉或页脚属性中包含“&G”代码，以在 Excel 工作表的页眉或页脚中插入图像。

以下代码显示了如何在 Python 中 Excel 工作表的页眉和页脚中插入图像：

from spire.xls import *from spire.xls.common import *# Open an Excel workbookworkbook = Workbookworkbook.LoadFromFile("Sales.xlsx")# Get the first worksheetsheet = workbook.Worksheets[0]# Load an imageimage = Stream("img.png")# Add the image to the left section of the headersheet.PageSetup.LeftHeaderImage = imagesheet.PageSetup.LeftHeader = "&G"# Add the image to the center section of the footersheet.PageSetup.CenterFooterImage = imagesheet.PageSetup.CenterFooter = "&G"# Change the view mode of the worksheet to the page layout viewsheet.ViewMode = ViewMode.Layout# Save the modified fileworkbook.SaveToFile("InsertImageInHeaderAndFooter.xlsx", ExcelVersion.Version2016)workbook.Dispose

使用 Python 在 Excel 的页眉和页脚中插入图像

打印多页文档时，您可能希望为奇数页和偶数页使用不同的页眉或页脚。这是打印报告和书籍中的常见功能。

在 Spire.XLS 中，DifferentOddEven 属性为奇数页和偶数页启用不同的页眉和页脚。OddHeaderString 和 EvenHeaderString 属性分别为奇数页和偶数页设置自定义标头。同样，OddFooterString 和 EvenFooterString 属性为奇数页和偶数页设置自定义页脚。

以下代码显示了如何在 Python 的 Excel 文件中为奇数页和偶数页插入不同的页眉和页脚：

from spire.xls import *# Open an Excel workbookworkbook = Workbookworkbook.LoadFromFile("Sales.xlsx")# Get the first worksheetsheet = workbook.Worksheets[0]# Set the different header footer for Odd and Even pagessheet.PageSetup.DifferentOddEven = 1sheet.PageSetup.OddHeaderString = "&\"Arial\"&14&B&KFF0000 Odd_Header"sheet.PageSetup.OddFooterString = "&\"Arial\"&14&B&KFF0000 Odd_Footer"sheet.PageSetup.EvenHeaderString = "&\"Arial\"&14&B&K00FF00 Even_Header"sheet.PageSetup.EvenFooterString = "&\"Arial\"&14&B&K00FF00 Even_Footer"# Change the view mode of the worksheet to the page layout viewsheet.ViewMode = ViewMode.Layout# Save the modified fileworkbook.SaveToFile("DifferentHeaderAndFooterForOddAndEvenPage.xlsx", ExcelVersion.Version2016)workbook.Dispose

使用 Python 在 Excel 中为奇数页和偶数页添加不同的页眉和页脚

以下代码演示如何在 Python 中为 Excel 文件中的第一页插入不同的页眉和页脚：

from spire.xls import *# Open an Excel workbookworkbook = Workbookworkbook.LoadFromFile("Sales.xlsx")# Get the first worksheetsheet = workbook.Worksheets[0]# Add a different header and footer for the first pagesheet.PageSetup.DifferentFirst = 1sheet.PageSetup.FirstHeaderString = "&\"Arial\"&14&KFF0000 First Page Header"sheet.PageSetup.FirstFooterString = "&\"Arial\"&14&KFF0000 First Page Footer"# Add a header and footer for the other pages sheet.PageSetup.CenterHeader = "&\"Arial\"&14&K00FF00 Other Page Header"sheet.PageSetup.CenterFooter = "&\"Arial\"&14&K00FF00 Other Page Footer"# Change the view mode of the worksheet to the page layout viewsheet.ViewMode = ViewMode.Layout# Save the modified file workbook.SaveToFile("DifferentFirstPageHeaderAndFooter.xlsx", ExcelVersion.Version2016)workbook.Dispose