使用页眉和页脚

Aspose.Words允许用户在文档中使用页眉和页脚。 页眉是放置在页面顶部的文本,页脚是页面底部的文本。 通常,这些区域用于插入应该在文档的所有或某些页面上重复的信息,例如页码、创建日期、公司信息等等。

使用DocumentBuilder创建页眉或页脚

如果要以编程方式添加文档页眉或页脚,最简单的方法是使用DocumentBuilder类来执行此操作。

下面的代码示例演示如何为文档页添加页眉和页脚:

指定页眉或页脚选项

向文档添加页眉或页脚时,可以设置一些高级属性。 Aspose.Words为用户提供HeaderFooterHeaderFooterCollection类,以及HeaderFooterType枚举,使您可以更好地控制页眉和页脚自定义过程。

指定页眉或页脚类型

您可以为一个文档指定三种不同的页眉类型和三种不同的页脚类型:

  1. 首页的页眉和/或页脚
  2. 偶数页的页眉和/或页脚
  3. 奇数页的页眉和/或页脚

下面的代码示例演示如何为奇数文档页添加标题:

指定是否为第一页显示不同的页眉或页脚

如上所述,您还可以为第一页设置不同的页眉或页脚。 为此,您需要将DifferentFirstPageHeaderFooter标志设置为true,然后指定HeaderFirstFooterFirst值。

下面的代码示例演示如何仅为第一页设置标头:

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Java.git.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
// Specify that we want different headers and footers for first page.
builder.getPageSetup().setDifferentFirstPageHeaderFooter(true);
builder.moveToHeaderFooter(HeaderFooterType.HEADER_FIRST);
builder.write("Header for the first page.");
builder.moveToHeaderFooter(HeaderFooterType.FOOTER_FIRST);
builder.write("Footer for the first page.");
builder.moveToSection(0);
builder.writeln("Page 1");
builder.insertBreak(BreakType.PAGE_BREAK);
builder.writeln("Page 2");
doc.save(getArtifactsDir() + "WorkingWithHeadersAndFooters.DifferentFirstPage.docx");

指定是否为奇数页或偶数页显示不同的页眉或页脚

接下来,您需要为文档中的奇数页和偶数页设置不同的页眉或页脚。 为此,您需要将OddAndEvenPagesHeaderFooter标志设置为true,然后指定值HeaderPrimaryHeaderEven,或FooterPrimaryFooterEven

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Java.git.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
// Specify that we want different headers and footers for even and odd pages.
builder.getPageSetup().setOddAndEvenPagesHeaderFooter(true);
builder.moveToHeaderFooter(HeaderFooterType.HEADER_EVEN);
builder.write("Header for even pages.");
builder.moveToHeaderFooter(HeaderFooterType.HEADER_PRIMARY);
builder.write("Header for odd pages.");
builder.moveToHeaderFooter(HeaderFooterType.FOOTER_EVEN);
builder.write("Footer for even pages.");
builder.moveToHeaderFooter(HeaderFooterType.FOOTER_PRIMARY);
builder.write("Footer for odd pages.");
builder.moveToSection(0);
builder.writeln("Page 1");
builder.insertBreak(BreakType.PAGE_BREAK);
builder.writeln("Page 2");
doc.save(getArtifactsDir() + "WorkingWithHeadersAndFooters.OddEvenPages.docx");

将绝对定位的图像插入标题

要将图像放置在页眉或页脚中,请使用HeaderPrimary页眉类型或FooterPrimary页脚类型和InsertImage方法。

下面的代码示例演示如何将图像添加到标头:

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Java.git.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
builder.moveToHeaderFooter(HeaderFooterType.HEADER_PRIMARY);
builder.insertImage(getImagesDir() + "Logo.jpg", RelativeHorizontalPosition.RIGHT_MARGIN, 10,
RelativeVerticalPosition.PAGE, 10, 50, 50, WrapType.THROUGH);
doc.save(getArtifactsDir() + "WorkingWithHeadersAndFooters.InsertImage.docx");

为页眉或页脚文本设置字体和段落属性

使用Aspose.Words,您可以设置字体和段落属性,使用HeaderPrimary页眉类型或FooterPrimary页脚类型,以及处理用于文档正文的字体和段落的方法和属性。

下面的代码示例演示如何将标题中的文本设置为Arial、bold、size14和center alignment:

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Java.git.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
builder.moveToHeaderFooter(HeaderFooterType.HEADER_PRIMARY);
builder.getParagraphFormat().setAlignment(ParagraphAlignment.CENTER);
builder.getFont().setName("Arial");
builder.getFont().setBold(true);
builder.getFont().setSize(14);
builder.write("Header for page.");
doc.save(getArtifactsDir() + "WorkingWithHeadersAndFooters.HeaderFooterFontProps.docx");
view raw font-props.java hosted with ❤ by GitHub

将页码插入页眉或页脚

如有必要,您可以将页码添加到页眉或页脚。 为此,请使用HeaderPrimary页眉类型或FooterPrimary页脚类型和InsertField方法添加所需字段。

下面的代码示例演示如何将页码添加到右侧的页脚:

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Java.git.
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
builder.moveToHeaderFooter(HeaderFooterType.FOOTER_PRIMARY);
builder.getParagraphFormat().setAlignment(ParagraphAlignment.RIGHT);
builder.write("Page ");
builder.insertField("PAGE", "");
builder.write(" of ");
builder.insertField("NUMPAGES", "");
doc.save(getArtifactsDir() + "WorkingWithHeadersAndFooters.PageNumbers.docx");

使用上一节中定义的页眉或页脚

如果您需要从上一节复制页眉或页脚,您也可以这样做。

下面的代码示例演示如何从上一节复制页眉或页脚:

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Java.git.
/// <summary>
/// Clones and copies headers/footers form the previous section to the specified section.
/// </summary>
private void copyHeadersFootersFromPreviousSection(Section section)
{
Section previousSection = (Section)section.getPreviousSibling();
if (previousSection == null)
return;
section.getHeadersFooters().clear();
for (HeaderFooter headerFooter : previousSection.getHeadersFooters())
section.getHeadersFooters().add(headerFooter.deepClone(true));
}

使用不同的页面方向和页面大小时,确保页眉或页脚外观

Aspose.Words允许您在使用不同的方向和页面大小时提供页眉或页脚的外观。

下面的示例演示如何执行此操作:

如何仅删除页眉或页脚

文档中的每个部分最多可以有三个页眉和三个页脚(第一页、偶数页和奇数页)。 如果要删除文档中的所有页眉或所有页脚,则需要循环遍历所有部分并删除每个相应的页眉节点或页脚节点。

下面的代码示例演示如何从所有节中删除所有页脚,但保持页眉不变。 您可以通过类似的方式仅删除标题:

// For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-Java.git.
Document doc = new Document(getMyDir() + "Header and footer types.docx");
for (Section section : doc.getSections())
{
// Up to three different footers are possible in a section (for first, even and odd pages)
// we check and delete all of them.
HeaderFooter footer = section.getHeadersFooters().getByHeaderFooterType(HeaderFooterType.FOOTER_FIRST);
footer.remove();
// Primary footer is the footer used for odd pages.
footer = section.getHeadersFooters().getByHeaderFooterType(HeaderFooterType.FOOTER_PRIMARY);
footer.remove();
footer = section.getHeadersFooters().getByHeaderFooterType(HeaderFooterType.FOOTER_EVEN);
footer.remove();
}
doc.save(getArtifactsDir() + "RemoveContent.RemoveFooters.docx");