wiki.xsx.core.pdf.footer.XEasyPdfFooter Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of x-easypdf Show documentation
A framework based on pdfbox
There is a newer version: 2.11.10
package wiki.xsx.core.pdf.footer;


import wiki.xsx.core.pdf.component.XEasyPdfComponent;
import wiki.xsx.core.pdf.doc.XEasyPdfDocument;
import wiki.xsx.core.pdf.doc.XEasyPdfPage;

import java.io.Serializable;

/**
 * pdf页脚组件接口
 *
 * @author xsx
 * @date 2020/6/7
 * @since 1.8
 * 
 * Copyright (c) 2020-2022 xsx All Rights Reserved.
 * x-easypdf is licensed under Mulan PSL v2.
 * You can use this software according to the terms and conditions of the Mulan PSL v2.
 * You may obtain a copy of Mulan PSL v2 at:
 * http://license.coscl.org.cn/MulanPSL2
 * THIS SOFTWARE IS PROVIDED ON AN "AS IS" BASIS, WITHOUT WARRANTIES OF ANY KIND,
 * EITHER EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO NON-INFRINGEMENT,
 * MERCHANTABILITY OR FIT FOR A PARTICULAR PURPOSE.
 * See the Mulan PSL v2 for more details.
 * 
 */
public interface XEasyPdfFooter extends Serializable {

    /**
     * 开启上下文重置
     *
     * @return 返回页脚组件
     */
    XEasyPdfFooter enableResetContext();

    /**
     * 设置边距（左右下）
     *
     * @param margin 边距
     * @return 返回页脚组件
     */
    XEasyPdfFooter setMargin(float margin);

    /**
     * 设置左边距
     *
     * @param margin 边距
     * @return 返回页脚组件
     */
    XEasyPdfFooter setMarginLeft(float margin);

    /**
     * 设置右边距
     *
     * @param margin 边距
     * @return 返回页脚组件
     */
    XEasyPdfFooter setMarginRight(float margin);

    /**
     * 设置下边距
     *
     * @param margin 边距
     * @return 返回页脚组件
     */
    XEasyPdfFooter setMarginBottom(float margin);

    /**
     * 添加自定义组件
     *
     * @param component pdf组件
     * @return 返回页脚组件
     */
    XEasyPdfFooter addComponent(XEasyPdfComponent component);

    /**
     * 获取页脚高度
     *
     * @param document pdf文档
     * @param page     pdf页面
     * @return 返回页脚高度
     */
    float getHeight(XEasyPdfDocument document, XEasyPdfPage page);

    /**
     * 获取总页码占位符
     *
     * @return 返回总页码占位符
     */
    String getTotalPagePlaceholder();

    /**
     * 获取当前页码占位符
     *
     * @return 返回当前页码占位符
     */
    String getCurrentPagePlaceholder();

    /**
     * 获取文本字体路径
     *
     * @return 返回文本字体路径
     */
    String getTextFontPath();

    /**
     * 检查组件
     *
     * @param component 组件
     * @return 返回布尔值，true为是，false为否
     */
    boolean check(XEasyPdfComponent component);

    /**
     * 绘制
     *
     * @param document pdf文档
     * @param page     pdf页面
     */
    void draw(XEasyPdfDocument document, XEasyPdfPage page);
}