使用页眉和页脚
Aspose.Words允许用户在文档中使用页眉和页脚。 页眉是放置在页面顶部的文本,页脚是页面底部的文本。 通常,这些区域用于插入应该在文档的所有或某些页面上重复的信息,例如页码、创建日期、公司信息等等。
使用DocumentBuilder创建页眉或页脚
如果要以编程方式添加文档页眉或页脚,最简单的方法是使用DocumentBuilder类来执行此操作。
下面的代码示例演示如何为文档页添加页眉和页脚:
指定页眉或页脚选项
向文档添加页眉或页脚时,可以设置一些高级属性。 Aspose.Words为用户提供HeaderFooter和HeaderFooterCollection类,以及HeaderFooterType枚举,使您可以更好地控制页眉和页脚自定义过程。
指定页眉或页脚类型
您可以为一个文档指定三种不同的页眉类型和三种不同的页脚类型:
- 首页的页眉和/或页脚
- 偶数页的页眉和/或页脚
- 奇数页的页眉和/或页脚
下面的代码示例演示如何为奇数文档页添加标题:
指定是否为第一页显示不同的页眉或页脚
如上所述,您还可以为第一页设置不同的页眉或页脚。 为此,您需要将DifferentFirstPageHeaderFooter标志设置为true
,然后指定HeaderFirst或FooterFirst值。
下面的代码示例演示如何仅为第一页设置标头:
// 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
,然后指定值HeaderPrimary和HeaderEven,或FooterPrimary和FooterEven。
// 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"); |
将页码插入页眉或页脚
如有必要,您可以将页码添加到页眉或页脚。 为此,请使用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"); |
使用上一节中定义的页眉或页脚
如果您需要从上一节复制页眉或页脚,您也可以这样做。
下面的代码示例演示如何从上一节复制页眉或页脚:
使用不同的页面方向和页面大小时,确保页眉或页脚外观
Aspose.Words允许您在使用不同的方向和页面大小时提供页眉或页脚的外观。
下面的示例演示如何执行此操作:
如何仅删除页眉或页脚
文档中的每个部分最多可以有三个页眉和三个页脚(第一页、偶数页和奇数页)。 如果要删除文档中的所有页眉或所有页脚,则需要循环遍历所有部分并删除每个相应的页眉节点或页脚节点。
下面的代码示例演示如何从所有节中删除所有页脚,但保持页眉不变。 您可以通过类似的方式仅删除标题: