com.itextpdf.text.Phrase Maven / Gradle / Ivy
Show all versions of itextpdf Show documentation
/*
* $Id: Phrase.java 5075 2012-02-27 16:36:18Z blowagie $
*
* This file is part of the iText (R) project.
* Copyright (c) 1998-2012 1T3XT BVBA
* 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 1T3XT,
* 1T3XT 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: [email protected]
*/
package com.itextpdf.text;
import java.util.ArrayList;
import java.util.Collection;
import com.itextpdf.text.Font.FontFamily;
import com.itextpdf.text.error_messages.MessageLocalization;
import com.itextpdf.text.pdf.HyphenationEvent;
/**
* A Phrase is a series of Chunks.
*
* A Phrase has a main Font, but some chunks
* within the phrase can have a Font that differs from the
* main Font. All the Chunks in a Phrase
* have the same leading.
*
* Example:
*
* // When no parameters are passed, the default leading = 16
* Phrase phrase0 = new Phrase();
* Phrase phrase1 = new Phrase("this is a phrase");
* // In this example the leading is passed as a parameter
* Phrase phrase2 = new Phrase(16, "this is a phrase with leading 16");
* // When a Font is passed (explicitly or embedded in a chunk), the default leading = 1.5 * size of the font
* Phrase phrase3 = new Phrase("this is a phrase with a red, normal font Courier, size 12", FontFactory.getFont(FontFactory.COURIER, 12, Font.NORMAL, new Color(255, 0, 0)));
* Phrase phrase4 = new Phrase(new Chunk("this is a phrase"));
* Phrase phrase5 = new Phrase(18, new Chunk("this is a phrase", FontFactory.getFont(FontFactory.HELVETICA, 16, Font.BOLD, new Color(255, 0, 0)));
*
*
* @see Element
* @see Chunk
* @see Paragraph
* @see Anchor
*/
public class Phrase extends ArrayList implements TextElementArray {
// constants
private static final long serialVersionUID = 2643594602455068231L;
// membervariables
/** This is the leading of this phrase. */
protected float leading = Float.NaN;
/** This is the font of this phrase. */
protected Font font;
/** Null, unless the Phrase has to be hyphenated.
* @since 2.1.2
*/
protected HyphenationEvent hyphenation = null;
// constructors
/**
* Constructs a Phrase without specifying a leading.
*/
public Phrase() {
this(16);
}
/**
* Copy constructor for Phrase.
* @param phrase the Phrase to copy
*/
public Phrase(final Phrase phrase) {
super();
this.addAll(phrase);
leading = phrase.getLeading();
font = phrase.getFont();
setHyphenation(phrase.getHyphenation());
}
/**
* Constructs a Phrase with a certain leading.
*
* @param leading the leading
*/
public Phrase(final float leading) {
this.leading = leading;
font = new Font();
}
/**
* Constructs a Phrase with a certain Chunk.
*
* @param chunk a Chunk
*/
public Phrase(final Chunk chunk) {
super.add(chunk);
font = chunk.getFont();
setHyphenation(chunk.getHyphenation());
}
/**
* Constructs a Phrase with a certain Chunk
* and a certain leading.
*
* @param leading the leading
* @param chunk a Chunk
*/
public Phrase(final float leading, final Chunk chunk) {
this.leading = leading;
super.add(chunk);
font = chunk.getFont();
setHyphenation(chunk.getHyphenation());
}
/**
* Constructs a Phrase with a certain String.
*
* @param string a String
*/
public Phrase(final String string) {
this(Float.NaN, string, new Font());
}
/**
* Constructs a Phrase with a certain String and a certain Font.
*
* @param string a String
* @param font a Font
*/
public Phrase(final String string, final Font font) {
this(Float.NaN, string, font);
}
/**
* Constructs a Phrase with a certain leading and a certain String.
*
* @param leading the leading
* @param string a String
*/
public Phrase(final float leading, final String string) {
this(leading, string, new Font());
}
/**
* Constructs a Phrase with a certain leading, a certain String
* and a certain Font.
*
* @param leading the leading
* @param string a String
* @param font a Font
*/
public Phrase(final float leading, final String string, final Font font) {
this.leading = leading;
this.font = font;
/* bugfix by August Detlefsen */
if (string != null && string.length() != 0) {
super.add(new Chunk(string, font));
}
}
// implementation of the Element-methods
/**
* Processes the element by adding it (or the different parts) to an
* ElementListener.
*
* @param listener an ElementListener
* @return true if the element was processed successfully
*/
public boolean process(final ElementListener listener) {
try {
for (Object element : this) {
listener.add((Element) element);
}
return true;
}
catch(DocumentException de) {
return false;
}
}
/**
* Gets the type of the text element.
*
* @return a type
*/
public int type() {
return Element.PHRASE;
}
/**
* Gets all the chunks in this element.
*
* @return an ArrayList
*/
public java.util.List getChunks() {
java.util.List tmp = new ArrayList();
for (Element element : this) {
tmp.addAll(element.getChunks());
}
return tmp;
}
/**
* @see com.itextpdf.text.Element#isContent()
* @since iText 2.0.8
*/
public boolean isContent() {
return true;
}
/**
* @see com.itextpdf.text.Element#isNestable()
* @since iText 2.0.8
*/
public boolean isNestable() {
return true;
}
// overriding some of the ArrayList-methods
/**
* Adds a Chunk, an Anchor or another Phrase
* to this Phrase.
*
* @param index index at which the specified element is to be inserted
* @param element an object of type Chunk, Anchor or Phrase
* @throws ClassCastException when you try to add something that isn't a Chunk, Anchor or Phrase
* @since 5.0.1 (signature changed to use Element)
*/
@Override
public void add(final int index, final Element element) {
if (element == null) return;
try {
if (element.type() == Element.CHUNK) {
Chunk chunk = (Chunk) element;
if (!font.isStandardFont()) {
chunk.setFont(font.difference(chunk.getFont()));
}
if (hyphenation != null && chunk.getHyphenation() == null && !chunk.isEmpty()) {
chunk.setHyphenation(hyphenation);
}
super.add(index, chunk);
}
// TODO same as in document - change else-if to generic adding that works everywhere
else if (element.type() == Element.PHRASE ||
element.type() == Element.ANCHOR ||
element.type() == Element.ANNOTATION ||
element.type() == Element.YMARK ||
element.type() == Element.MARKED || element.type() == Element.WRITABLE_DIRECT) {
super.add(index, element);
}
else {
throw new ClassCastException(String.valueOf(element.type()));
}
}
catch(ClassCastException cce) {
throw new ClassCastException(MessageLocalization.getComposedMessage("insertion.of.illegal.element.1", cce.getMessage()));
}
}
/**
* Adds a String to this Phrase.
*
* @param s a string
* @return a boolean
* @since 5.0.1
*/
public boolean add(final String s) {
if (s == null) {
return false;
}
return super.add(new Chunk(s, font));
}
/**
* Adds a Chunk, Anchor or another Phrase
* to this Phrase.
*
* @param element an object of type Chunk, Anchor or Phrase
* @return a boolean
* @throws ClassCastException when you try to add something that isn't a Chunk, Anchor or Phrase
* @since 5.0.1 (signature changed to use Element)
*/
@Override
public boolean add(final Element element) {
if (element == null) return false;
try {
// TODO same as in document - change switch to generic adding that works everywhere
switch(element.type()) {
case Element.CHUNK:
return addChunk((Chunk) element);
case Element.PHRASE:
case Element.PARAGRAPH:
Phrase phrase = (Phrase) element;
boolean success = true;
Element e;
for (Object element2 : phrase) {
e = (Element) element2;
if (e instanceof Chunk) {
success &= addChunk((Chunk)e);
}
else {
success &= this.add(e);
}
}
return success;
case Element.MARKED:
case Element.ANCHOR:
case Element.ANNOTATION:
case Element.PTABLE: // case added by mr. Karen Vardanyan
case Element.LIST:
case Element.YMARK:
case Element.WRITABLE_DIRECT:
return super.add(element);
default:
throw new ClassCastException(String.valueOf(element.type()));
}
}
catch(ClassCastException cce) {
throw new ClassCastException(MessageLocalization.getComposedMessage("insertion.of.illegal.element.1", cce.getMessage()));
}
}
/**
* Adds a collection of Chunks
* to this Phrase.
*
* @param collection a collection of Chunks, Anchors and Phrases.
* @return true if the action succeeded, false if not.
* @throws ClassCastException when you try to add something that isn't a Chunk, Anchor or Phrase
*/
@Override
public boolean addAll(final Collection collection) {
for (Element e: collection) {
this.add(e);
}
return true;
}
/**
* Adds a Chunk.
*
* This method is a hack to solve a problem I had with phrases that were split between chunks
* in the wrong place.
* @param chunk a Chunk to add to the Phrase
* @return true if adding the Chunk succeeded
*/
protected boolean addChunk(final Chunk chunk) {
Font f = chunk.getFont();
String c = chunk.getContent();
if (font != null && !font.isStandardFont()) {
f = font.difference(chunk.getFont());
}
if (size() > 0 && !chunk.hasAttributes()) {
try {
Chunk previous = (Chunk) get(size() - 1);
if (!previous.hasAttributes()
&& (f == null
|| f.compareTo(previous.getFont()) == 0)
&& !"".equals(previous.getContent().trim())
&& !"".equals(c.trim())) {
previous.append(c);
return true;
}
}
catch(ClassCastException cce) {
}
}
Chunk newChunk = new Chunk(c, f);
newChunk.setAttributes(chunk.getAttributes());
if (hyphenation != null && newChunk.getHyphenation() == null && !newChunk.isEmpty()) {
newChunk.setHyphenation(hyphenation);
}
return super.add(newChunk);
}
/**
* Adds an Element to the Paragraph.
*
* @param object the object to add.
*/
protected void addSpecial(final Element object) {
super.add(object);
}
// other methods that change the member variables
/**
* Sets the leading of this phrase.
*
* @param leading the new leading
*/
public void setLeading(final float leading) {
this.leading = leading;
}
/**
* Sets the main font of this phrase.
* @param font the new font
*/
public void setFont(final Font font) {
this.font = font;
}
// methods to retrieve information
/**
* Gets the leading of this phrase.
*
* @return the linespacing
*/
public float getLeading() {
if (Float.isNaN(leading) && font != null) {
return font.getCalculatedLeading(1.5f);
}
return leading;
}
/**
* Checks you if the leading of this phrase is defined.
*
* @return true if the leading is defined
*/
public boolean hasLeading() {
if (Float.isNaN(leading)) {
return false;
}
return true;
}
/**
* Gets the font of the first Chunk that appears in this Phrase.
*
* @return a Font
*/
public Font getFont() {
return font;
}
/**
* Returns the content as a String object.
* This method differs from toString because toString will return an ArrayList with the toString value of the Chunks in this Phrase.
* @return the content
*/
public String getContent() {
StringBuffer buf = new StringBuffer();
for (Chunk c: getChunks()) {
buf.append(c.toString());
}
return buf.toString();
}
/**
* Checks is this Phrase contains no or 1 empty Chunk.
*
* @return false if the Phrase
* contains more than one or more non-emptyChunks.
*/
@Override
public boolean isEmpty() {
switch(size()) {
case 0:
return true;
case 1:
Element element = get(0);
if (element.type() == Element.CHUNK && ((Chunk) element).isEmpty()) {
return true;
}
return false;
default:
return false;
}
}
/**
* Getter for the hyphenation settings.
* @return a HyphenationEvent
* @since 2.1.2
*/
public HyphenationEvent getHyphenation() {
return hyphenation;
}
/**
* Setter for the hyphenation.
* @param hyphenation a HyphenationEvent instance
* @since 2.1.2
*/
public void setHyphenation(final HyphenationEvent hyphenation) {
this.hyphenation = hyphenation;
}
// kept for historical reasons; people should use FontSelector
// eligible for deprecation, but the methods are mentioned in the book p277.
/**
* Constructs a Phrase that can be used in the static getInstance() method.
* @param dummy a dummy parameter
*/
private Phrase(final boolean dummy) {
}
/**
* Gets a special kind of Phrase that changes some characters into corresponding symbols.
* @param string
* @return a newly constructed Phrase
*/
public static final Phrase getInstance(final String string) {
return getInstance(16, string, new Font());
}
/**
* Gets a special kind of Phrase that changes some characters into corresponding symbols.
* @param leading
* @param string
* @return a newly constructed Phrase
*/
public static final Phrase getInstance(final int leading, final String string) {
return getInstance(leading, string, new Font());
}
/**
* Gets a special kind of Phrase that changes some characters into corresponding symbols.
* @param leading
* @param string
* @param font
* @return a newly constructed Phrase
*/
public static final Phrase getInstance(final int leading, String string, final Font font) {
Phrase p = new Phrase(true);
p.setLeading(leading);
p.font = font;
if (font.getFamily() != FontFamily.SYMBOL && font.getFamily() != FontFamily.ZAPFDINGBATS && font.getBaseFont() == null) {
int index;
while((index = SpecialSymbol.index(string)) > -1) {
if (index > 0) {
String firstPart = string.substring(0, index);
p.add(new Chunk(firstPart, font));
string = string.substring(index);
}
Font symbol = new Font(FontFamily.SYMBOL, font.getSize(), font.getStyle(), font.getColor());
StringBuffer buf = new StringBuffer();
buf.append(SpecialSymbol.getCorrespondingSymbol(string.charAt(0)));
string = string.substring(1);
while (SpecialSymbol.index(string) == 0) {
buf.append(SpecialSymbol.getCorrespondingSymbol(string.charAt(0)));
string = string.substring(1);
}
p.add(new Chunk(buf.toString(), symbol));
}
}
if (string != null && string.length() != 0) {
p.add(new Chunk(string, font));
}
return p;
}
}