com.lowagie.text.Phrase Maven / Gradle / Ivy
Show all versions of rtf-gen Show documentation
/*
* $Id: Phrase.java 3942 2009-05-28 18:14:10Z blowagie $
*
* 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/osobolev/rtf-gen
*/
package com.lowagie.text;
import java.util.ArrayList;
import java.util.Collection;
/**
* A Phrase
is a series of Chunk
s.
*
* A Phrase
has a main Font
, but some chunks
* within the phrase can have a Font
that differs from the
* main Font
. All the Chunk
s 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;
// constructors
/**
* Constructs a Phrase
without specifying a leading.
*/
public Phrase() {
this(16);
}
/**
* Copy constructor for Phrase
.
*/
public Phrase(Phrase phrase) {
this.addAll(phrase);
leading = phrase.getLeading();
font = phrase.getFont();
}
/**
* Constructs a Phrase
with a certain leading.
*
* @param leading the leading
*/
public Phrase(float leading) {
this.leading = leading;
font = new Font();
}
/**
* Constructs a Phrase
with a certain Chunk
.
*
* @param chunk a Chunk
*/
public Phrase(Chunk chunk) {
super.add(chunk);
font = chunk.getFont();
}
/**
* Constructs a Phrase
with a certain Chunk
* and a certain leading.
*
* @param leading the leading
* @param chunk a Chunk
*/
public Phrase(float leading, Chunk chunk) {
this.leading = leading;
super.add(chunk);
font = chunk.getFont();
}
/**
* Constructs a Phrase
with a certain String
.
*
* @param string a String
*/
public Phrase(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(String string, 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(float leading, 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(float leading, String string, 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(ElementListener listener) {
try {
for (Element element : this) {
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.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;
}
/**
* @since iText 2.0.8
* @see com.lowagie.text.Element#isContent()
*/
public boolean isContent() {
return true;
}
/**
* @since iText 2.0.8
* @see com.lowagie.text.Element#isNestable()
*/
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 o an object of type Chunk
, Anchor
or Phrase
* @throws ClassCastException when you try to add something that isn't a Chunk
, Anchor
or Phrase
*/
public void add(int index, Element o) {
if (o == null) return;
try {
if (o.type() == Element.CHUNK) {
Chunk chunk = (Chunk) o;
if (!font.isStandardFont()) {
chunk.setFont(font.difference(chunk.getFont()));
}
super.add(index, chunk);
} else if (o.type() == Element.PHRASE ||
o.type() == Element.ANCHOR ||
o.type() == Element.ANNOTATION ||
o.type() == Element.TABLE || // line added by David Freels
o.type() == Element.YMARK ||
o.type() == Element.MARKED) {
super.add(index, o);
} else {
throw new ClassCastException(String.valueOf(o.type()));
}
} catch (ClassCastException cce) {
throw new ClassCastException("Insertion of illegal Element: " + cce.getMessage());
}
}
/**
* Adds a Chunk
, Anchor
or another Phrase
* to this Phrase
.
*
* @param o 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
*/
public boolean add(Element o) {
if (o == null) return false;
try {
switch (o.type()) {
case Element.CHUNK:
return addChunk((Chunk) o);
case Element.PHRASE:
case Element.PARAGRAPH:
Phrase phrase = (Phrase) o;
boolean success = true;
for (Element e : phrase) {
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.TABLE: // case added by David Freels
case Element.LIST:
case Element.YMARK:
return super.add(o);
default:
throw new ClassCastException(String.valueOf(o.type()));
}
} catch (ClassCastException cce) {
throw new ClassCastException("Insertion of illegal Element: " + cce.getMessage());
}
}
public boolean add(String o) {
return super.add(new Chunk(o, font));
}
/**
* Adds a collection of Chunk
s
* to this Phrase
.
*
* @param collection a collection of Chunk
s, Anchor
s and Phrase
s.
* @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
*/
public boolean addAll(Collection extends Element> collection) {
for (Element element : collection) {
this.add(element);
}
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(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.same(previous.getFont()))
&& !"".equals(previous.getContent().trim())
&& !"".equals(c.trim())) {
previous.append(c);
return true;
}
} catch (ClassCastException cce) {
// ignore
}
}
Chunk newChunk = new Chunk(c, f);
newChunk.setAttributes(chunk.getAttributes());
return super.add(newChunk);
}
/**
* Adds a Object
to the Paragraph
.
*
* @param object the object to add.
*/
protected void addSpecial(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(float leading) {
this.leading = leading;
}
/**
* Sets the main font of this phrase.
*
* @param font the new font
*/
public void setFont(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() {
return !Float.isNaN(leading);
}
/**
* 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.
*/
public String getContent() {
StringBuilder buf = new StringBuilder();
for (Element element : getChunks()) {
buf.append(element.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-emptyChunk
s.
*/
public boolean isEmpty() {
switch (size()) {
case 0:
return true;
case 1:
Element element = get(0);
return element.type() == Element.CHUNK && ((Chunk) element).isEmpty();
default:
return false;
}
}
// 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(boolean dummy) {
}
/**
* Gets a special kind of Phrase that changes some characters into corresponding symbols.
*
* @param string
* @return a newly constructed Phrase
*/
public static Phrase getInstance(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 Phrase getInstance(int leading, 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 Phrase getInstance(int leading, String string, Font font) {
Phrase p = new Phrase(true);
p.setLeading(leading);
p.font = font;
if (font.getFamily() != Font.SYMBOL && font.getFamily() != Font.ZAPFDINGBATS) {
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(Font.SYMBOL, font.getSize(), font.getStyle(), font.getColor());
StringBuilder buf = new StringBuilder();
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;
}
}