com.itextpdf.text.pdf.PdfPageEvent.java Source code

Java tutorial

Introduction

Here is the source code for com.itextpdf.text.pdf.PdfPageEvent.java

Source

/*
 *
 * This file is part of the iText (R) project.
Copyright (c) 1998-2019 iText Group NV
 * Authors: Bruno Lowagie, Paulo Soares, et al.
 *
 * This program is free software; you can redistribute it and/or modify
 * it under the terms of the GNU Affero General Public License version 3
 * as published by the Free Software Foundation with the addition of the
 * following permission added to Section 15 as permitted in Section 7(a):
 * FOR ANY PART OF THE COVERED WORK IN WHICH THE COPYRIGHT IS OWNED BY
 * ITEXT GROUP. ITEXT GROUP DISCLAIMS THE WARRANTY OF NON INFRINGEMENT
 * OF THIRD PARTY RIGHTS
 *
 * This program is distributed in the hope that it will be useful, but
 * WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
 * or FITNESS FOR A PARTICULAR PURPOSE.
 * See the GNU Affero General Public License for more details.
 * You should have received a copy of the GNU Affero General Public License
 * along with this program; if not, see http://www.gnu.org/licenses or write to
 * the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
 * Boston, MA, 02110-1301 USA, or download the license from the following URL:
 * http://itextpdf.com/terms-of-use/
 *
 * The interactive user interfaces in modified source and object code versions
 * of this program must display Appropriate Legal Notices, as required under
 * Section 5 of the GNU Affero General Public License.
 *
 * In accordance with Section 7(b) of the GNU Affero General Public License,
 * a covered work must retain the producer line in every PDF that is created
 * or manipulated using iText.
 *
 * You can be released from the requirements of the license by purchasing
 * a commercial license. Buying such a license is mandatory as soon as you
 * develop commercial activities involving the iText software without
 * disclosing the source code of your own applications.
 * These activities include: offering paid services to customers as an ASP,
 * serving PDFs on the fly in a web application, shipping iText with a closed
 * source product.
 *
 * For more information, please contact iText Software Corp. at this
 * address: sales@itextpdf.com
 */
package com.itextpdf.text.pdf;

import com.itextpdf.text.Document;
import com.itextpdf.text.Paragraph;
import com.itextpdf.text.Rectangle;

/**
 * Allows a class to catch several document events.
 *<p>
 * Note: do not use Document.add() inside a page event.
 *
 * @author  Paulo Soares
 */

public interface PdfPageEvent {

    /**
     * Called when the document is opened.
     *
     * @param writer the <CODE>PdfWriter</CODE> for this document
     * @param document the document
     */
    public void onOpenDocument(PdfWriter writer, Document document);

    /**
     * Called when a page is initialized.
     * <P>
     * Note that if even if a page is not written this method is still
     * called. It is preferable to use <CODE>onEndPage</CODE> to avoid
     * infinite loops.
     * </P>
     * <P>
     * Note that this method isn't called for the first page. You should apply modifications for the first
     * page either before opening the document or by using the onOpenDocument() method.
     * </P>
     *
     * @param writer the <CODE>PdfWriter</CODE> for this document
     * @param document the document
     */
    public void onStartPage(PdfWriter writer, Document document);

    /**
     * Called when a page is finished, just before being written to the document.
     *
     * @param writer the <CODE>PdfWriter</CODE> for this document
     * @param document the document
     */
    public void onEndPage(PdfWriter writer, Document document);

    /**
     * Called when the document is closed.
     * <P>
     * Note that this method is called with the page number equal
     * to the last page plus one.
     *
     * @param writer the <CODE>PdfWriter</CODE> for this document
     * @param document the document
     */
    public void onCloseDocument(PdfWriter writer, Document document);

    /**
     * Called when a Paragraph is written.
     * <P>
     * <CODE>paragraphPosition</CODE> will hold the height at which the
     * paragraph will be written to. This is useful to insert bookmarks with
     * more control.
     *
     * @param writer the <CODE>PdfWriter</CODE> for this document
     * @param document the document
     * @param paragraphPosition the position the paragraph will be written to
     */
    public void onParagraph(PdfWriter writer, Document document, float paragraphPosition);

    /**
     * Called when a Paragraph is written.
     * <P>
     * <CODE>paragraphPosition</CODE> will hold the height of the end of the paragraph.
     *
     * @param writer the <CODE>PdfWriter</CODE> for this document
     * @param document the document
     * @param paragraphPosition the position of the end of the paragraph
     */
    public void onParagraphEnd(PdfWriter writer, Document document, float paragraphPosition);

    /**
     * Called when a Chapter is written.
     * <P>
     * <CODE>position</CODE> will hold the height at which the
     * chapter will be written to.
     *
     * @param writer            the <CODE>PdfWriter</CODE> for this document
     * @param document          the document
     * @param paragraphPosition the position the chapter will be written to
     * @param title             the title of the Chapter
     */
    public void onChapter(PdfWriter writer, Document document, float paragraphPosition, Paragraph title);

    /**
     * Called when the end of a Chapter is reached.
     * <P>
     * <CODE>position</CODE> will hold the height of the end of the chapter.
     *
     * @param writer            the <CODE>PdfWriter</CODE> for this document
     * @param document          the document
     * @param paragraphPosition the position the chapter will be written to
     */
    public void onChapterEnd(PdfWriter writer, Document document, float paragraphPosition);

    /**
     * Called when a Section is written.
     * <P>
     * <CODE>position</CODE> will hold the height at which the
     * section will be written to.
     *
     * @param writer            the <CODE>PdfWriter</CODE> for this document
     * @param document          the document
     * @param paragraphPosition the position the section will be written to
     * @param depth            the number depth of the section
     * @param title             the title of the section
     */
    public void onSection(PdfWriter writer, Document document, float paragraphPosition, int depth, Paragraph title);

    /**
     * Called when the end of a Section is reached.
     * <P>
     * <CODE>position</CODE> will hold the height of the section end.
     *
     * @param writer            the <CODE>PdfWriter</CODE> for this document
     * @param document          the document
     * @param paragraphPosition the position the section will be written to
     */
    public void onSectionEnd(PdfWriter writer, Document document, float paragraphPosition);

    /**
     * Called when a <CODE>Chunk</CODE> with a generic tag is written.
     * <P>
     * It is useful to pinpoint the <CODE>Chunk</CODE> location to generate
     * bookmarks, for example.
     *
     * @param writer the <CODE>PdfWriter</CODE> for this document
     * @param document the document
     * @param rect the <CODE>Rectangle</CODE> containing the <CODE>Chunk</CODE>
     * @param text the text of the tag
     */
    public void onGenericTag(PdfWriter writer, Document document, Rectangle rect, String text);
}