页眉页脚

页眉页脚是指在文档的顶部和底部处添加标注，通常包含标题、页码、品牌标识等信息。通过给文档添加页眉和页脚，使文档更易导航和辨识，提高文档的可读性和专业性。

在 PDF 文档中只能存在一个页眉页脚，添加新的页眉页脚会覆盖旧的页眉页脚。

添加页眉页脚

添加页眉页脚的步骤如下：

1. 获取文档中的页眉页脚对象。

2. 设置需要添加页眉页脚的页面。

3. 设置页眉页脚颜色，字体大小等属性。

4. 将页眉页脚更新到页面上。

以下是添加页眉页脚的示例代码：

CPDFDocument document = new CPDFDocument();
document.open("test.pdf");

CPDFHeaderFooter headerFooter = document.getHeaderFooter();

// 顶部中间（索引 1）
headerFooter.setText(1, "Header - <<1>>");
headerFooter.setFontName(1, "Helvetica");
headerFooter.setFontSize(1, 14f);
headerFooter.setTextColor(1, 0xFF000000);

// 底部中间（索引 4）
headerFooter.setText(4, "Page <<1>>");
headerFooter.setFontName(4, "Helvetica");
headerFooter.setFontSize(4, 12f);
headerFooter.setTextColor(4, 0xFF000000);

headerFooter.setMargin(20f, 20f, 20f, 20f);
headerFooter.setPageOffset(1);
headerFooter.setPages("0,1,2,3,4");
headerFooter.setRules(0);

headerFooter.update();

document.save(outputPath, CPDFDocument.PDFDocumentSaveType.PDFDocumentSaveNoIncremental);
headerFooter.release();
document.close();

页眉页脚正则表达式说明

页眉页脚支持特定格式的正则表达式，当设置headerFooter.setRules(1)时生效，格式为：<<\d+,\d+>>|<<\d+>>|<<\d+,>>

• <<i>> : i表示页码的起始值。
• <<i,f>>:i表示页码的起始值，f为页码位数，如果实际页码不够，会在前面自动补充0。 例如：当文本被设置为"<<1,2>> 页"时，在第一页上显示的文本为"01 页"。

移除页眉页脚

移除页眉页脚的步骤如下：

1. 获取文档中的页眉页脚对象。

2. 清除页眉页脚。

以下是删除页眉页脚的示例代码：

CPDFDocument document = new CPDFDocument();
document.open(inputPath);

CPDFHeaderFooter headerFooter = document.getHeaderFooter();
System.out.println("isValid: " + headerFooter.isValid());

// 清除
headerFooter.clear();
document.save(clearPath, CPDFDocument.PDFDocumentSaveType.PDFDocumentSaveNoIncremental);
headerFooter.release();
document.close();