All Downloads are FREE. Search and download functionalities are using the official Maven repository.

com.lowagie.text.Section Maven / Gradle / Ivy

There is a newer version: 1.2.2.1-jre17
Show newest version
/*
 * $Id: Section.java 4065 2009-09-16 23:09:11Z psoares33 $
 * $Name$
 *
 * Copyright 1999, 2000, 2001, 2002 by Bruno Lowagie.
 *
 * The contents of this file are subject to the Mozilla Public License Version 1.1
 * (the "License"); you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at http://www.mozilla.org/MPL/
 *
 * Software distributed under the License is distributed on an "AS IS" basis,
 * WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License
 * for the specific language governing rights and limitations under the License.
 *
 * The Original Code is 'iText, a free JAVA-PDF library'.
 *
 * The Initial Developer of the Original Code is Bruno Lowagie. Portions created by
 * the Initial Developer are Copyright (C) 1999, 2000, 2001, 2002 by Bruno Lowagie.
 * All Rights Reserved.
 * Co-Developer of the code is Paulo Soares. Portions created by the Co-Developer
 * are Copyright (C) 2000, 2001, 2002 by Paulo Soares. All Rights Reserved.
 *
 * Contributor(s): all the names of the contributors are added in the source code
 * where applicable.
 *
 * Alternatively, the contents of this file may be used under the terms of the
 * LGPL license (the "GNU LIBRARY GENERAL PUBLIC LICENSE"), in which case the
 * provisions of LGPL are applicable instead of those above.  If you wish to
 * allow use of your version of this file only under the terms of the LGPL
 * License and not to allow others to use your version of this file under
 * the MPL, indicate your decision by deleting the provisions above and
 * replace them with the notice and other provisions required by the LGPL.
 * If you do not delete the provisions above, a recipient may use your version
 * of this file under either the MPL or the GNU LIBRARY GENERAL PUBLIC LICENSE.
 *
 * This library is free software; you can redistribute it and/or modify it
 * under the terms of the MPL as stated above or under the terms of the GNU
 * Library General Public License as published by the Free Software Foundation;
 * either version 2 of the License, or any later version.
 *
 * This library 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 Library general Public License for more
 * details.
 *
 * If you didn't download this code from the following link, you should check if
 * you aren't using an obsolete version:
 * https://github.com/LibrePDF/OpenPDF
 */

package com.lowagie.text;

import java.util.ArrayList;
import java.util.Collection;
import java.util.Iterator;
import com.lowagie.text.error_messages.MessageLocalization;

/**
 * A Section is a part of a Document containing
 * other Sections, Paragraphs, List
 * and/or Tables.
 * 

* Remark: you can not construct a Section yourself. * You will have to ask an instance of Section to the * Chapter or Section to which you want to * add the new Section. *

* Example: *

 * Paragraph title2 = new Paragraph("This is Chapter 2", FontFactory.getFont(FontFactory.HELVETICA, 18, Font.BOLDITALIC, new Color(0, 0, 255)));
 * Chapter chapter2 = new Chapter(title2, 2);
 * Paragraph someText = new Paragraph("This is some text");
 * chapter2.add(someText);
 * Paragraph title21 = new Paragraph("This is Section 1 in Chapter 2", FontFactory.getFont(FontFactory.HELVETICA, 16, Font.BOLD, new Color(255, 0, 0)));
 * Section section1 = chapter2.addSection(title21);
 * Paragraph someSectionText = new Paragraph("This is some silly paragraph in a chapter and/or section. It contains some text to test the functionality of Chapters and Section.");
 * section1.add(someSectionText);
 * Paragraph title211 = new Paragraph("This is SubSection 1 in Section 1 in Chapter 2", FontFactory.getFont(FontFactory.HELVETICA, 14, Font.BOLD, new Color(255, 0, 0)));
 * Section section11 = section1.addSection(40, title211, 2);
 * section11.add(someSectionText);
 * 
*/ public class Section extends ArrayList implements TextElementArray, LargeElement { // constant /** * A possible number style. The default number style: "1.2.3." * @since iText 2.0.8 */ public static final int NUMBERSTYLE_DOTTED = 0; /** * A possible number style. For instance: "1.2.3" * @since iText 2.0.8 */ public static final int NUMBERSTYLE_DOTTED_WITHOUT_FINAL_DOT = 1; /** A serial version uid. */ private static final long serialVersionUID = 3324172577544748043L; // member variables /** The title of this section. */ protected Paragraph title; /** The bookmark title if different from the content title */ protected String bookmarkTitle; /** The number of sectionnumbers that has to be shown before the section title. */ protected int numberDepth; /** * The style for sectionnumbers. * @since iText 2.0.8 */ protected int numberStyle = NUMBERSTYLE_DOTTED; /** The indentation of this section on the left side. */ protected float indentationLeft; /** The indentation of this section on the right side. */ protected float indentationRight; /** The additional indentation of the content of this section. */ protected float indentation; /** false if the bookmark children are not visible */ protected boolean bookmarkOpen = true; /** true if the section has to trigger a new page */ protected boolean triggerNewPage = false; /** This is the number of subsections. */ protected int subsections = 0; /** This is the complete list of sectionnumbers of this section and the parents of this section. */ protected java.util.List numbers = null; /** * Indicates if the Section will be complete once added to the document. * @since iText 2.0.8 */ protected boolean complete = true; /** * Indicates if the Section was added completely to the document. * @since iText 2.0.8 */ protected boolean addedCompletely = false; /** * Indicates if this is the first time the section was added. * @since iText 2.0.8 */ protected boolean notAddedYet = true; // constructors /** * Constructs a new Section. */ protected Section() { title = new Paragraph(); numberDepth = 1; } /** * Constructs a new Section. * * @param title a Paragraph * @param numberDepth the numberDepth */ protected Section(Paragraph title, int numberDepth) { this.numberDepth = numberDepth; this.title = title; } // implementation of the Element-methods /** * Processes the element by adding it (or the different parts) to an * ElementListener. * * @param listener the ElementListener * @return true if the element was processed successfully */ public boolean process(ElementListener listener) { try { Element element; for (Object o : this) { element = (Element) o; listener.add(element); } return true; } catch(DocumentException de) { return false; } } /** * Gets the type of the text element. * * @return a type */ public int type() { return Element.SECTION; } /** * Checks if this object is a Chapter. * * @return true if it is a Chapter, * false if it is a Section. */ public boolean isChapter() { return type() == Element.CHAPTER; } /** * Checks if this object is a Section. * * @return true if it is a Section, * false if it is a Chapter. */ public boolean isSection() { return type() == Element.SECTION; } /** * Gets all the chunks in this element. * * @return an ArrayList */ public ArrayList getChunks() { ArrayList tmp = new ArrayList<>(); for (Element o : this) { tmp.addAll(o.getChunks()); } return tmp; } /** * @see com.lowagie.text.Element#isContent() * @since iText 2.0.8 */ public boolean isContent() { return true; } /** * @see com.lowagie.text.Element#isNestable() * @since iText 2.0.8 */ public boolean isNestable() { return false; } // overriding some of the ArrayList-methods /** * Adds a Paragraph, List or Table * to this Section. * * @param index index at which the specified element is to be inserted * @param o an object of type Paragraph, List or Table= * @throws ClassCastException if the object is not a Paragraph, List or Table */ public void add(int index, Element o) { if (isAddedCompletely()) { throw new IllegalStateException(MessageLocalization.getComposedMessage("this.largeelement.has.already.been.added.to.the.document")); } try { Element element = o; if (element.isNestable()) { super.add(index, element); } else { throw new ClassCastException(MessageLocalization.getComposedMessage("you.can.t.add.a.1.to.a.section", element.getClass().getName())); } } catch(ClassCastException cce) { throw new ClassCastException(MessageLocalization.getComposedMessage("insertion.of.illegal.element.1", cce.getMessage())); } } /** * Adds a Paragraph, List, Table or another Section * to this Section. * * @param o an object of type Paragraph, List, Table or another Section * @return a boolean * @throws ClassCastException if the object is not a Paragraph, List, Table or Section */ public boolean add(Element o) { if (isAddedCompletely()) { throw new IllegalStateException(MessageLocalization.getComposedMessage("this.largeelement.has.already.been.added.to.the.document")); } try { Element element = o; if (element.type() == Element.SECTION) { Section section = (Section) o; section.setNumbers(++subsections, numbers); return super.add(section); } else if (o instanceof MarkedSection && ((MarkedObject)o).element.type() == Element.SECTION) { MarkedSection mo = (MarkedSection)o; Section section = (Section)mo.element; section.setNumbers(++subsections, numbers); return super.add(mo); } else if (element.isNestable()) { return super.add(o); } else { throw new ClassCastException(MessageLocalization.getComposedMessage("you.can.t.add.a.1.to.a.section", element.getClass().getName())); } } catch(ClassCastException cce) { throw new ClassCastException(MessageLocalization.getComposedMessage("insertion.of.illegal.element.1", cce.getMessage())); } } /** * Adds a collection of Elements * to this Section. * * @param collection a collection of Paragraphs, Lists and/or Tables * @return true if the action succeeded, false if not. * @throws ClassCastException if one of the objects isn't a Paragraph, List, Table */ public boolean addAll(Collection collection) { for (Element o : collection) { this.add(o); } return true; } // methods that return a Section /** * Creates a Section, adds it to this Section and returns it. * * @param indentation the indentation of the new section * @param title the title of the new section * @param numberDepth the numberDepth of the section * @return a new Section object */ public Section addSection(float indentation, Paragraph title, int numberDepth) { if (isAddedCompletely()) { throw new IllegalStateException(MessageLocalization.getComposedMessage("this.largeelement.has.already.been.added.to.the.document")); } Section section = new Section(title, numberDepth); section.setIndentation(indentation); add(section); return section; } /** * Creates a Section, adds it to this Section and returns it. * * @param indentation the indentation of the new section * @param title the title of the new section * @return a new Section object */ public Section addSection(float indentation, Paragraph title) { return addSection(indentation, title, numberDepth + 1); } /** * Creates a Section, add it to this Section and returns it. * * @param title the title of the new section * @param numberDepth the numberDepth of the section * @return a new Section object */ public Section addSection(Paragraph title, int numberDepth) { return addSection(0, title, numberDepth); } /** * Adds a marked section. For use in class MarkedSection only! * * @return an object of {@link MarkedSection} */ public MarkedSection addMarkedSection() { MarkedSection section = new MarkedSection(new Section(null, numberDepth + 1)); add(section); return section; } /** * Creates a Section, adds it to this Section and returns it. * * @param title the title of the new section * @return a new Section object */ public Section addSection(Paragraph title) { return addSection(0, title, numberDepth + 1); } /** * Adds a Section to this Section and returns it. * * @param indentation the indentation of the new section * @param title the title of the new section * @param numberDepth the numberDepth of the section * @return a new Section object */ public Section addSection(float indentation, String title, int numberDepth) { return addSection(indentation, new Paragraph(title), numberDepth); } /** * Adds a Section to this Section and returns it. * * @param title the title of the new section * @param numberDepth the numberDepth of the section * @return a new Section object */ public Section addSection(String title, int numberDepth) { return addSection(new Paragraph(title), numberDepth); } /** * Adds a Section to this Section and returns it. * * @param indentation the indentation of the new section * @param title the title of the new section * @return a new Section object */ public Section addSection(float indentation, String title) { return addSection(indentation, new Paragraph(title)); } /** * Adds a Section to this Section and returns it. * * @param title the title of the new section * @return a new Section object */ public Section addSection(String title) { return addSection(new Paragraph(title)); } // public methods /** * Sets the title of this section. * * @param title the new title */ public void setTitle(Paragraph title) { this.title = title; } /** * Returns the title, preceded by a certain number of sectionnumbers. * * @return a Paragraph */ public Paragraph getTitle() { return constructTitle(title, numbers, numberDepth, numberStyle); } /** * Constructs a Paragraph that will be used as title for a Section or Chapter. * @param title the title of the section * @param numbers a list of sectionnumbers * @param numberDepth how many numbers have to be shown * @param numberStyle the numbering style * @return a Paragraph object * @since iText 2.0.8 */ public static Paragraph constructTitle(Paragraph title, java.util.List numbers, int numberDepth, int numberStyle) { if (title == null) { return null; } int depth = Math.min(numbers.size(), numberDepth); if (depth < 1) { return title; } StringBuilder buf = new StringBuilder(" "); for (int i = 0; i < depth; i++) { buf.insert(0, "."); buf.insert(0, numbers.get(i).intValue()); } if (numberStyle == NUMBERSTYLE_DOTTED_WITHOUT_FINAL_DOT) { buf.deleteCharAt(buf.length() - 2); } Paragraph result = new Paragraph(title); result.add(0, new Chunk(buf.toString(), title.getFont())); return result; } /** * Sets the depth of the sectionnumbers that will be shown preceding the title. *

* If the numberdepth is 0, the sections will not be numbered. If the numberdepth * is 1, the section will be numbered with their own number. If the numberdepth is * higher (for instance {@literal x > 1}), the numbers of {@literal x - 1} parents will be shown. * * @param numberDepth the new numberDepth */ public void setNumberDepth(int numberDepth) { this.numberDepth = numberDepth; } /** * Returns the numberdepth of this Section. * * @return the numberdepth */ public int getNumberDepth() { return numberDepth; } /** * Sets the style for numbering sections. * Possible values are NUMBERSTYLE_DOTTED: 1.2.3. (the default) * or NUMBERSTYLE_DOTTED_WITHOUT_FINAL_DOT: 1.2.3 * * @param numberStyle {@link Section#numberStyle} * @since iText 2.0.8 */ public void setNumberStyle(int numberStyle) { this.numberStyle = numberStyle; } /** * Gets the style used for numbering sections. * * @return a value corresponding with a numbering style * @since iText 2.0.8 */ public int getNumberStyle() { return numberStyle; } /** * Sets the indentation of this Section on the left side. * * @param indentation the indentation */ public void setIndentationLeft(float indentation) { indentationLeft = indentation; } /** * Returns the indentation of this Section on the left side. * * @return the indentation */ public float getIndentationLeft() { return indentationLeft; } /** * Sets the indentation of this Section on the right side. * * @param indentation the indentation */ public void setIndentationRight(float indentation) { indentationRight = indentation; } /** * Returns the indentation of this Section on the right side. * * @return the indentation */ public float getIndentationRight() { return indentationRight; } /** * Sets the indentation of the content of this Section. * * @param indentation the indentation */ public void setIndentation(float indentation) { this.indentation = indentation; } /** * Returns the indentation of the content of this Section. * * @return the indentation */ public float getIndentation() { return indentation; } /** Setter for property bookmarkOpen. * @param bookmarkOpen false if the bookmark children are not * visible. */ public void setBookmarkOpen(boolean bookmarkOpen) { this.bookmarkOpen = bookmarkOpen; } /** * Getter for property bookmarkOpen. * @return Value of property bookmarkOpen. */ public boolean isBookmarkOpen() { return bookmarkOpen; } /** * Setter for property triggerNewPage. * @param triggerNewPage true if a new page has to be triggered. */ public void setTriggerNewPage(boolean triggerNewPage) { this.triggerNewPage = triggerNewPage; } /** * Getter for property bookmarkOpen. * @return Value of property triggerNewPage. */ public boolean isTriggerNewPage() { return triggerNewPage && notAddedYet; } /** * Sets the bookmark title. The bookmark title is the same as the section title but * can be changed with this method. * @param bookmarkTitle the bookmark title */ public void setBookmarkTitle(String bookmarkTitle) { this.bookmarkTitle = bookmarkTitle; } /** * Gets the bookmark title. * @return the bookmark title */ public Paragraph getBookmarkTitle() { if (bookmarkTitle == null) return getTitle(); else return new Paragraph(bookmarkTitle); } /** * Changes the Chapter number. * * @param number new chapter number */ public void setChapterNumber(int number) { numbers.set(numbers.size() - 1, number); Object s; for (Object o : this) { s = o; if (s instanceof Section) { ((Section) s).setChapterNumber(number); } } } /** * Returns the depth of this section. * * @return the depth */ public int getDepth() { return numbers.size(); } // private methods /** * Sets the number of this section. * * @param number the number of this section * @param numbers an ArrayList, containing the numbers of the Parent */ private void setNumbers(int number, java.util.List numbers) { this.numbers = new ArrayList<>(); this.numbers.add(number); this.numbers.addAll(numbers); } /** * Indicates if this is the first time the section is added. * @since iText2.0.8 * @return true if the section wasn't added yet */ public boolean isNotAddedYet() { return notAddedYet; } /** * Sets the indication if the section was already added to * the document. * @since iText2.0.8 * @param notAddedYet {@link Section#notAddedYet} */ public void setNotAddedYet(boolean notAddedYet) { this.notAddedYet = notAddedYet; } /** * * @return boolean, true if section is added completely, else false * @since iText 2.0.8 */ protected boolean isAddedCompletely() { return addedCompletely; } /** * * @param addedCompletely {@link Section#addedCompletely} * @since iText 2.0.8 */ protected void setAddedCompletely(boolean addedCompletely) { this.addedCompletely = addedCompletely; } /** * @since iText 2.0.8 * @see com.lowagie.text.LargeElement#flushContent() */ public void flushContent() { setNotAddedYet(false); title = null; Element element; for (Iterator i = iterator(); i.hasNext(); ) { element = (Element)i.next(); if (element instanceof Section) { Section s = (Section)element; if (!s.isComplete() && size() == 1) { s.flushContent(); return; } else { s.setAddedCompletely(true); } } i.remove(); } } /** * @since iText 2.0.8 * @see com.lowagie.text.LargeElement#isComplete() */ public boolean isComplete() { return complete; } /** * @since iText 2.0.8 * @see com.lowagie.text.LargeElement#setComplete(boolean) */ public void setComplete(boolean complete) { this.complete = complete; } /** * Adds a new page to the section. * @since 2.1.1 */ public void newPage() { this.add(Chunk.NEXTPAGE); } }





© 2015 - 2024 Weber Informatics LLC | Privacy Policy