页面对象

xsx大约 6 分钟对象模式页面对象

介绍

说明

本章节将介绍页面对象的基本用法。

特别注意

由于多个页面序列会导致总页码不准确，建议仅创建一个页面对象。

创建对象

Page page = TemplateHandler.Page.build();

基本用法

说明

创建一个灰色背景页面的文档

对象模式 java 代码

// 定义输出路径
String outputPath = "E:\\pdf\\test\\fo\\test.pdf";
// 创建文档
Document document = TemplateHandler.Document.build();
// 创建页面（空白页，灰色背景）
Page page = TemplateHandler.Page.build().setBodyBackgroundColor("gray");
// 添加页面
document.addPage(page);
// 转换pdf
document.transform(outputPath);

xsl-fo 模板

说明

对象模式生成的对应 xsl-fo 模板

<?xml version="1.0" encoding="UTF-8"?><!--根标签-->
<fo:root xmlns:fo="http://www.w3.org/1999/XSL/Format"
         xmlns:fox="http://xmlgraphics.apache.org/fop/extensions"
         xmlns:xe="http://www.x-easypdf.cn/ns"
         xmlns:svg="http://www.w3.org/2000/svg">
    <!--页面模板-->
    <fo:layout-master-set>
        <fo:simple-page-master master-name="page1" page-height="29.7cm" page-width="21cm">
            <fo:region-body background-color="gray"/>
            <fo:region-before/>
            <fo:region-after/>
            <fo:region-start/>
            <fo:region-end/>
        </fo:simple-page-master>
    </fo:layout-master-set>
    <fo:page-sequence master-reference="page1">
        <fo:flow flow-name="xsl-region-body">
            <fo:block/>
        </fo:flow>
    </fo:page-sequence>
</fo:root>

pdf 文档效果

添加页眉

说明

创建一个带有页眉的文档

特别注意

添加页眉时，需要将页面主体上边距设置大于等于页眉高度，否则将导致内容重叠。

对象模式 java 代码

// 定义输出路径
String outputPath = "E:\\pdf\\test\\fo\\test.pdf";
// 创建文档
Document document = TemplateHandler.Document.build();
// 创建页面（空白页）
Page page = TemplateHandler.Page.build();
// 创建页眉文本
Text headerText = TemplateHandler.Text.build().setText("页眉").setFontFamily("微软雅黑");
// 创建页面主体文本
Text bodyText = TemplateHandler.Text.build().setText("页面内容").setFontFamily("微软雅黑");
// 设置页眉高度并添加页眉文本
page.setHeaderHeight("30pt").addHeaderComponent(headerText);
// 设置页面主体上边距并添加页面主体文本
page.setBodyMarginTop("30pt").addBodyComponent(bodyText);
// 添加页面
document.addPage(page);
// 转换pdf
document.transform(outputPath);

xsl-fo 模板

说明

对象模式生成的对应 xsl-fo 模板

<?xml version="1.0" encoding="UTF-8"?><!--根标签-->
<fo:root xmlns:fo="http://www.w3.org/1999/XSL/Format"
         xmlns:fox="http://xmlgraphics.apache.org/fop/extensions"
         xmlns:xe="http://www.x-easypdf.cn/ns"
         xmlns:svg="http://www.w3.org/2000/svg">
    <!--页面模板-->
    <fo:layout-master-set>
        <fo:simple-page-master master-name="page1" page-height="29.7cm" page-width="21cm">
            <fo:region-body margin-top="30pt"/>
            <fo:region-before extent="30pt"/>
            <fo:region-after/>
            <fo:region-start/>
            <fo:region-end/>
        </fo:simple-page-master>
    </fo:layout-master-set>
    <fo:page-sequence master-reference="page1">
        <fo:static-content flow-name="xsl-region-before">
            <fo:block>
                <fo:inline font-family="微软雅黑">页眉</fo:inline>
            </fo:block>
        </fo:static-content>
        <fo:flow flow-name="xsl-region-body">
            <fo:block>
                <fo:inline font-family="微软雅黑">页面内容</fo:inline>
            </fo:block>
        </fo:flow>
    </fo:page-sequence>
</fo:root>

pdf 文档效果

添加页脚

说明

创建一个带有页脚的文档

特别注意

添加页脚时，需要将页面主体下边距设置大于等于页脚高度，否则将导致内容重叠。

对象模式 java 代码

// 定义输出路径
String outputPath = "E:\\pdf\\test\\fo\\test.pdf";
// 创建文档
Document document = TemplateHandler.Document.build();
// 创建页面
Page page = TemplateHandler.Page.build();
// 创建页眉文本
Text footerText = TemplateHandler.Text.build().setText("页脚").setFontFamily("微软雅黑");
// 创建页面主体文本
Text bodyText = TemplateHandler.Text.build().setText("页面内容").setFontFamily("微软雅黑");
// 设置页脚高度并添加页脚文本
page.setFooterHeight("30pt").addFooterComponent(footerText);
// 设置页面主体下边距并添加页面主体文本
page.setBodyMarginBottom("30pt").addBodyComponent(bodyText);
// 添加页面
document.addPage(page);
// 转换pdf
document.transform(outputPath);

xsl-fo 模板

说明

对象模式生成的对应 xsl-fo 模板

<?xml version="1.0" encoding="UTF-8"?><!--根标签-->
<fo:root xmlns:fo="http://www.w3.org/1999/XSL/Format"
         xmlns:fox="http://xmlgraphics.apache.org/fop/extensions"
         xmlns:xe="http://www.x-easypdf.cn/ns"
         xmlns:svg="http://www.w3.org/2000/svg">
    <!--页面模板-->
    <fo:layout-master-set>
        <fo:simple-page-master master-name="page1" page-height="29.7cm" page-width="21cm">
            <fo:region-body margin-bottom="30pt"/>
            <fo:region-before/>
            <fo:region-after extent="30pt"/>
            <fo:region-start/>
            <fo:region-end/>
        </fo:simple-page-master>
    </fo:layout-master-set>
    <fo:page-sequence master-reference="page1">
        <fo:static-content flow-name="xsl-region-after">
            <fo:block>
                <fo:inline font-family="微软雅黑">页脚</fo:inline>
            </fo:block>
        </fo:static-content>
        <fo:flow flow-name="xsl-region-body">
            <fo:block>
                <fo:inline font-family="微软雅黑">页面内容</fo:inline>
            </fo:block>
        </fo:flow>
    </fo:page-sequence>
</fo:root>