Java 插入Excel页眉、页脚

前言

在Excel文档中，我们常用页眉页脚来显示文档的附加信息，例如日期、公司名称、Logo或作者信息等。本文将通过Java程序来介绍如何给Excel文档添加页眉页脚。代码示例主要从以下几方面来演示添加方法。

• 添加页眉页脚（文本、图片）
• 为奇偶页添加不同的页眉页脚
• 为首页和其他页添加不同的页眉页脚

在运行代码前，需要添加Jar包到IDEA中。添加方法有两种：其一，在官网上下载Free Spire.XLS for Java产品包，解压后找到lib文件夹下的Spire.Xls.jar，然后手动将其导入IDEA中即可；其二（推荐使用），通过Maven仓库安装导入产品及依赖。创建一个Maven项目，在pom.xml文件中输入以下代码，然后点击“Import Changes”即可。

<repositories>
        <repository>
            <id>com.e-iceblue</id>
            <url>http://repo.e-iceblue.cn/repository/maven-public/</url>
        </repository>
    </repositories>
<dependencies>
    <dependency>
        <groupId>e-iceblue</groupId>
        <artifactId>spire.xls.free</artifactId>
        <version>2.2.0</version>
    </dependency>
</dependencies>

代码示例

【示例1】添加页眉、页脚（文本、图片）

Free Spire.XLS for Java支持添加文本、图片到页眉页脚。其中可设置添加位置（靠左、居中、靠右）及文本的字体、字号、颜色等。另外，还需注意Excel页眉或页脚在普通浏览模式下不可见，它们仅在页面布局模式或者打印预览模式才可见。

import com.spire.xls.*;
import javax.imageio.ImageIO;
import java.awt.image.BufferedImage;
import java.io.*;

public class HeaderFooter {
    public static void main(String[] args) throws IOException {
        //加载Excel示例文档
        Workbook workbook= new Workbook();
        workbook.loadFromFile("C:\\Users\\Test1\\Desktop\\Test.xlsx");

        //获取第一个工作表
        Worksheet Worksheet = workbook.getWorksheets().get(0);

        //添加文本到页眉页脚，并设置其字体、字号、颜色和位置
        Worksheet.getPageSetup().setRightHeader("&\"微软雅黑\"&14 腾飞广告有限公司");
        Worksheet.getPageSetup().setRightFooter("&\"微软雅黑\"&12&B&KFF0000 注：仅用于内部员工查看");
        //加载图片
        BufferedImage image = ImageIO.read( new File("C:\\Users\\Test1\\Desktop\\Image.png"));

        //添加图片到页眉，并设置位置
        Worksheet.getPageSetup().setLeftHeaderImage(image);
        Worksheet.getPageSetup().setLeftHeader("&G");
        //添加图片到页脚
        //Worksheet.getPageSetup().setCenterFooterImage(image);
        //Worksheet.getPageSetup().setCenterFooter("&G");

        //设置显示样式
        Worksheet.setViewMode(ViewMode.Layout);

        //保存文档
        workbook.saveToFile("output/HeaderFooter.xlsx", ExcelVersion.Version2010);
    }
}

添加效果

【示例2】为奇偶页添加不同的页眉页脚

Free Spire.XLS for Java提供了setDifferentOddEven方法来为Excel文档中的奇偶页添加不同的页眉页脚。在添加的同时，可设置文本字体、字号和颜色。

import com.spire.xls.*;
public class DifferentHeaderFooter {
    public static void main(String[] args) {

        //加载Excel示例文档
        Workbook workbook = new Workbook();
        workbook.loadFromFile("C:\\Users\\Test1\\Desktop\\Test.xlsx");
     
       //获取第一个工作表
        Worksheet worksheet = workbook.getWorksheets().get(0);

        //设置第一页，第二页
        worksheet.getCellRange("A1").setText("");
        worksheet.getCellRange("M1").setText("第二页");

        //将setDifferentOddEven的值设为1, 表示奇数页和偶数页可以分别设置页眉页脚
        worksheet.getPageSetup().setDifferentOddEven((byte)1);

        //设置奇数页及偶数页页眉页脚，样式和颜色
        worksheet.getPageSetup().setOddHeaderString( "&\"Arial\"&20&B&K191970 奇数_页眉");
        worksheet.getPageSetup().setOddFooterString ( "&\"Arial\"&20&B&K191970 奇数_页脚");
        worksheet.getPageSetup().setEvenHeaderString ( "&\"Arial\"&20&B&KFF0000 偶数_页眉");
        worksheet.getPageSetup().setEvenFooterString ( "&\"Arial\"&20&B&KFF0000 偶数_页脚");

        //设置显示样式
        worksheet.setViewMode(ViewMode.Layout);

        //保存文档
        workbook.saveToFile("output/DifferentHeaderFooter.xlsx", ExcelVersion.Version2010);
    }
}

添加效果

【示例3】为首页和其他页添加不同的页眉页脚

import com.spire.xls.*;
public class DifferentHeaderFooterOnFirstPage {
    public static void main(String[] args) {
        //加载Excel示例文档
        Workbook workbook = new Workbook();
        workbook.loadFromFile("C:\\Users\\Test1\\Desktop\\Test.xlsx");
        //获取第一个工作表
        Worksheet worksheet = workbook.getWorksheets().get(0);

        //设置第一页，第二页
        worksheet.getCellRange("A1").setText("");
        worksheet.getCellRange("M1").setText("第二页");

        //将setDifferentFirst的值设为1，表示第一页和其他页可分别设置页眉页脚
        worksheet.getPageSetup().setDifferentFirst((byte)1);

        //设置第一页页眉页脚，样式和颜色
        worksheet.getPageSetup().setFirstHeaderString("&\"Arial\"&B&20&KFF0000第一页_页眉");
        worksheet.getPageSetup().setFirstFooterString("&\"Arial\"&B&20&KFF0000第一页_页脚");

        //设置其他页的页眉页脚，样式和颜色
        worksheet.getPageSetup().setCenterHeader("&\"Arial\"&B&20&K191970其它页_页眉");
        worksheet.getPageSetup().setCenterFooter("&\"Arial\"&B&20&K191970其它页_页眉");

        //保存文档
        workbook.saveToFile("output/DifferentHeaderFooterOnFirstPage.xlsx", ExcelVersion.Version2013);
    }
}

添加效果

总结

通过以上代码示例，我们可以成功地为Excel文档添加页眉页脚，同时，对于一些个性化的需求，我们也可以为奇偶页添加不同的页眉页脚、为首页和其他页添加不同页眉页脚、文字格式化（如，设置字体、字号、字体颜色等）操作。