Initial import of release 2.2.REL-2.2@923

git-svn-id: https://joinup.ec.europa.eu/svn/pdf-as/trunk@4 7b5415b0-85f9-ee4d-85bd-d5d0c3b42d1c

1 files changed, 937 insertions, 0 deletions

diff --git a/src/main/java/com/lowagie/text/Chunk.java b/src/main/java/com/lowagie/text/Chunk.java
new file mode 100644
index 0000000..c72e54c
--- /dev/null
+++ b/src/main/java/com/lowagie/text/Chunk.java
@@ -0,0 +1,937 @@
+/*

+ * $Id: Chunk.java,v 1.114 2005/12/08 14:56:53 psoares33 Exp $

+ * $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:

+ * http://www.lowagie.com/iText/

+ */

+

+package com.lowagie.text;

+

+import java.awt.Color;

+import java.util.ArrayList;

+import java.util.Collections;

+import java.util.HashMap;

+import java.util.Hashtable;

+import java.util.Properties;

+import java.util.Set;

+import java.net.URL;

+

+import com.lowagie.text.pdf.PdfAction;

+import com.lowagie.text.pdf.PdfAnnotation;

+import com.lowagie.text.pdf.HyphenationEvent;

+import com.lowagie.text.pdf.PdfContentByte;

+import com.lowagie.text.markup.MarkupTags;

+import com.lowagie.text.markup.MarkupParser;

+

+/**

+ * This is the smallest significant part of text that can be added to a

+ * document.

+ * <P>

+ * Most elements can be divided in one or more <CODE>Chunk</CODE>s. A chunk

+ * is a <CODE>String</CODE> with a certain <CODE>Font</CODE>. All other

+ * layout parameters should be defined in the object to which this chunk of text

+ * is added.

+ * <P>

+ * Example: <BLOCKQUOTE>

+ * 

+ * <PRE>

+ * 

+ * <STRONG>Chunk chunk = new Chunk("Hello world",

+ * FontFactory.getFont(FontFactory.COURIER, 20, Font.ITALIC, new Color(255, 0,

+ * 0))); </STRONG> document.add(chunk);

+ * 

+ * </PRE>

+ * 

+ * </BLOCKQUOTE>

+ */

+

+public class Chunk implements Element, MarkupAttributes {

+

+	// public static membervariables

+

+	/**

+	 * The character stand in for an image.

+	 */

+	public static final String OBJECT_REPLACEMENT_CHARACTER = "\ufffc";

+

+	/** This is a Chunk containing a newline. */

+	public static final Chunk NEWLINE = new Chunk("\n");

+

+	/** This is a Chunk containing a newpage. */

+	public static final Chunk NEXTPAGE = new Chunk("");

+	static {

+		NEXTPAGE.setNewPage();

+	}

+

+	/** Key for sub/superscript. */

+	public static final String SUBSUPSCRIPT = "SUBSUPSCRIPT";

+

+	/** Key for underline. */

+	public static final String UNDERLINE = "UNDERLINE";

+

+	/** Key for color. */

+	public static final String COLOR = "COLOR";

+

+	/** Key for encoding. */

+	public static final String ENCODING = "ENCODING";

+

+	/** Key for remote goto. */

+	public static final String REMOTEGOTO = "REMOTEGOTO";

+

+	/** Key for local goto. */

+	public static final String LOCALGOTO = "LOCALGOTO";

+

+	/** Key for local destination. */

+	public static final String LOCALDESTINATION = "LOCALDESTINATION";

+

+	/** Key for image. */

+	public static final String IMAGE = "IMAGE";

+

+	/** Key for generic tag. */

+	public static final String GENERICTAG = "GENERICTAG";

+

+	/** Key for newpage. */

+	public static final String NEWPAGE = "NEWPAGE";

+

+	/** Key for split character. */

+	public static final String SPLITCHARACTER = "SPLITCHARACTER";

+

+	/** Key for Action. */

+	public static final String ACTION = "ACTION";

+

+	/** Key for background. */

+	public static final String BACKGROUND = "BACKGROUND";

+

+	/** Key for annotation. */

+	public static final String PDFANNOTATION = "PDFANNOTATION";

+

+	/** Key for hyphenation. */

+	public static final String HYPHENATION = "HYPHENATION";

+

+	/** Key for text rendering mode. */

+	public static final String TEXTRENDERMODE = "TEXTRENDERMODE";

+

+	/** Key for text skewing. */

+	public static final String SKEW = "SKEW";

+

+	/** Key for text horizontal scaling. */

+	public static final String HSCALE = "HSCALE";

+

+	// member variables

+

+	/** This is the content of this chunk of text. */

+	protected StringBuffer content = null;

+

+	/** This is the <CODE>Font</CODE> of this chunk of text. */

+	protected Font font = null;

+

+	/** Contains some of the attributes for this Chunk. */

+	protected HashMap attributes = null;

+

+	/** Contains extra markupAttributes */

+	protected Properties markupAttributes = null;

+

+	// constructors

+

+	/**

+	 * Empty constructor.

+	 */

+	protected Chunk() {

+	}

+

+    /**

+     * A <CODE>Chunk</CODE> copy constructor.

+     * @param ck the <CODE>Chunk</CODE> to be copied

+     */    

+    public Chunk(Chunk ck) {

+        if (ck.content != null) {

+            content = new StringBuffer(ck.content.toString());

+        }

+        if (ck.font != null) {

+            font = new Font(ck.font);

+        }

+        if (ck.attributes != null) {

+            attributes = new HashMap(ck.attributes);

+        }

+        if (ck.markupAttributes != null) {

+            markupAttributes = new Properties();

+            markupAttributes.putAll(ck.markupAttributes);

+        }

+    }

+    

+	/**

+	 * Constructs a chunk of text with a certain content and a certain <CODE>

+	 * Font</CODE>.

+	 * 

+	 * @param content

+	 *            the content

+	 * @param font

+	 *            the font

+	 */

+

+	public Chunk(String content, Font font) {

+		this.content = new StringBuffer(content);

+		this.font = font;

+	}

+

+	/**

+	 * Constructs a chunk of text with a certain content, without specifying a

+	 * <CODE>Font</CODE>.

+	 * 

+	 * @param content

+	 *            the content

+	 */

+	public Chunk(String content) {

+		this(content, new Font());

+	}

+

+	/**

+	 * Constructs a chunk of text with a char and a certain <CODE>Font</CODE>.

+	 * 

+	 * @param c

+	 *            the content

+	 * @param font

+	 *            the font

+	 */

+	public Chunk(char c, Font font) {

+		this.content = new StringBuffer();

+		this.content.append(c);

+		this.font = font;

+	}

+

+	/**

+	 * Constructs a chunk of text with a char, without specifying a <CODE>Font

+	 * </CODE>.

+	 * 

+	 * @param c

+	 *            the content

+	 */

+	public Chunk(char c) {

+		this(c, new Font());

+	}

+

+	/**

+	 * Constructs a chunk containing an <CODE>Image</CODE>.

+	 * 

+	 * @param image

+	 *            the image

+	 * @param offsetX

+	 *            the image offset in the x direction

+	 * @param offsetY

+	 *            the image offset in the y direction

+	 */

+

+	public Chunk(Image image, float offsetX, float offsetY) {

+		this(OBJECT_REPLACEMENT_CHARACTER, new Font());

+		Image copyImage = Image.getInstance(image);

+		copyImage.setAbsolutePosition(Float.NaN, Float.NaN);

+		setAttribute(IMAGE, new Object[] { copyImage, new Float(offsetX),

+				new Float(offsetY), new Boolean(false) });

+	}

+

+	/**

+	 * Constructs a chunk containing an <CODE>Image</CODE>.

+	 * 

+	 * @param image

+	 *            the image

+	 * @param offsetX

+	 *            the image offset in the x direction

+	 * @param offsetY

+	 *            the image offset in the y direction

+	 * @param changeLeading

+	 *            true if the leading has to be adapted to the image

+	 */

+

+	public Chunk(Image image, float offsetX, float offsetY,

+			boolean changeLeading) {

+		this(OBJECT_REPLACEMENT_CHARACTER, new Font());

+		setAttribute(IMAGE, new Object[] { image, new Float(offsetX),

+				new Float(offsetY), new Boolean(changeLeading) });

+	}

+

+	/**

+	 * Returns a <CODE>Chunk</CODE> that has been constructed taking in

+	 * account the value of some <VAR>attributes </VAR>.

+	 * 

+	 * @param attributes

+	 *            Some attributes

+	 */

+

+	public Chunk(Properties attributes) {

+		this("", FontFactory.getFont(attributes));

+		String value;

+		if ((value = (String) attributes.remove(ElementTags.ITEXT)) != null) {

+			append(value);

+		}

+		if ((value = (String) attributes.remove(ElementTags.LOCALGOTO)) != null) {

+			setLocalGoto(value);

+		}

+		if ((value = (String) attributes.remove(ElementTags.REMOTEGOTO)) != null) {

+			String destination = (String) attributes

+					.remove(ElementTags.DESTINATION);

+			String page = (String) attributes.remove(ElementTags.PAGE);

+			if (page != null) {

+				setRemoteGoto(value, Integer.parseInt(page));

+			} else if (destination != null) {

+				setRemoteGoto(value, destination);

+			}

+		}

+		if ((value = (String) attributes.remove(ElementTags.LOCALDESTINATION)) != null) {

+			setLocalDestination(value);

+		}

+		if ((value = (String) attributes.remove(ElementTags.SUBSUPSCRIPT)) != null) {

+			setTextRise(Float.valueOf(value + "f").floatValue());

+		}

+		if ((value = (String) attributes

+				.remove(MarkupTags.CSS_KEY_VERTICALALIGN)) != null

+				&& value.endsWith("%")) {

+			float p = Float.valueOf(

+					value.substring(0, value.length() - 1) + "f").floatValue() / 100f;

+			setTextRise(p * font.size());

+		}

+		if ((value = (String) attributes.remove(ElementTags.GENERICTAG)) != null) {

+			setGenericTag(value);

+		}

+		if ((value = (String) attributes.remove(ElementTags.BACKGROUNDCOLOR)) != null) {

+			setBackground(MarkupParser.decodeColor(value));

+		}

+		if (attributes.size() > 0)

+			setMarkupAttributes(attributes);

+	}

+

+	// implementation of the Element-methods

+

+	/**

+	 * Processes the element by adding it (or the different parts) to an <CODE>

+	 * ElementListener</CODE>.

+	 * 

+	 * @param listener

+	 *            an <CODE>ElementListener</CODE>

+	 * @return <CODE>true</CODE> if the element was processed successfully

+	 */

+

+	public boolean process(ElementListener listener) {

+		try {

+			return listener.add(this);

+		} catch (DocumentException de) {

+			return false;

+		}

+	}

+

+	/**

+	 * Gets the type of the text element.

+	 * 

+	 * @return a type

+	 */

+

+	public int type() {

+		return Element.CHUNK;

+	}

+

+	/**

+	 * Gets all the chunks in this element.

+	 * 

+	 * @return an <CODE>ArrayList</CODE>

+	 */

+

+	public ArrayList getChunks() {

+		ArrayList tmp = new ArrayList();

+		tmp.add(this);

+		return tmp;

+	}

+

+	// methods

+

+	/**

+	 * appends some text to this <CODE>Chunk</CODE>.

+	 * 

+	 * @param string

+	 *            <CODE>String</CODE>

+	 * @return a <CODE>StringBuffer</CODE>

+	 */

+

+	public StringBuffer append(String string) {

+		return content.append(string);

+	}

+

+	// methods to retrieve information

+

+	/**

+	 * Gets the font of this <CODE>Chunk</CODE>.

+	 * 

+	 * @return a <CODE>Font</CODE>

+	 */

+

+	public Font font() {

+		return font;

+	}

+

+	/**

+	 * Sets the font of this <CODE>Chunk</CODE>.

+	 * 

+	 * @param font

+	 *            a <CODE>Font</CODE>

+	 */

+

+	public void setFont(Font font) {

+		this.font = font;

+	}

+

+	/**

+	 * Returns the content of this <CODE>Chunk</CODE>.

+	 * 

+	 * @return a <CODE>String</CODE>

+	 */

+

+	public String content() {

+		return content.toString();

+	}

+

+	/**

+	 * Returns the content of this <CODE>Chunk</CODE>.

+	 * 

+	 * @return a <CODE>String</CODE>

+	 */

+

+	public String toString() {

+		return content.toString();

+	}

+

+	/**

+	 * Checks is this <CODE>Chunk</CODE> is empty.

+	 * 

+	 * @return <CODE>false</CODE> if the Chunk contains other characters than

+	 *         space.

+	 */

+

+	public boolean isEmpty() {

+		return (content.toString().trim().length() == 0)

+				&& (content.toString().indexOf("\n") == -1)

+				&& (attributes == null);

+	}

+

+	/**

+	 * Gets the width of the Chunk in points.

+	 * 

+	 * @return a width in points

+	 */

+	public float getWidthPoint() {

+		if (getImage() != null) {

+			return getImage().scaledWidth();

+		}

+		return font.getCalculatedBaseFont(true).getWidthPoint(content(),

+				font.getCalculatedSize())

+				* getHorizontalScaling();

+	}

+

+	/**

+	 * Sets the text displacement relative to the baseline. Positive values rise

+	 * the text, negative values lower the text.

+	 * <P>

+	 * It can be used to implement sub/superscript.

+	 * 

+	 * @param rise

+	 *            the displacement in points

+	 * @return this <CODE>Chunk</CODE>

+	 */

+

+	public Chunk setTextRise(float rise) {

+		return setAttribute(SUBSUPSCRIPT, new Float(rise));

+	}

+

+	/**

+	 * Gets the text displacement relatiev to the baseline.

+	 * 

+	 * @return a displacement in points

+	 */

+	public float getTextRise() {

+		if (attributes.containsKey(SUBSUPSCRIPT)) {

+			Float f = (Float) attributes.get(SUBSUPSCRIPT);

+			return f.floatValue();

+		}

+		return 0.0f;

+	}

+

+	/**

+	 * Sets the text rendering mode. It can outline text, simulate bold and make

+	 * text invisible.

+	 * 

+	 * @param mode

+	 *            the text rendering mode. It can be <CODE>

+	 *            PdfContentByte.TEXT_RENDER_MODE_FILL</CODE>,<CODE>

+	 *            PdfContentByte.TEXT_RENDER_MODE_STROKE</CODE>,<CODE>

+	 *            PdfContentByte.TEXT_RENDER_MODE_FILL_STROKE</CODE> and <CODE>

+	 *            PdfContentByte.TEXT_RENDER_MODE_INVISIBLE</CODE>.

+	 * @param strokeWidth

+	 *            the stroke line width for the modes <CODE>

+	 *            PdfContentByte.TEXT_RENDER_MODE_STROKE</CODE> and <CODE>

+	 *            PdfContentByte.TEXT_RENDER_MODE_FILL_STROKE</CODE>.

+	 * @param strokeColor

+	 *            the stroke color or <CODE>null</CODE> to follow the text

+	 *            color

+	 * @return this <CODE>Chunk</CODE>

+	 */

+	public Chunk setTextRenderMode(int mode, float strokeWidth,

+			Color strokeColor) {

+		return setAttribute(TEXTRENDERMODE, new Object[] { new Integer(mode),

+				new Float(strokeWidth), strokeColor });

+	}

+

+	/**

+	 * Skews the text to simulate italic and other effects. Try <CODE>alpha=0

+	 * </CODE> and <CODE>beta=12</CODE>.

+	 * 

+	 * @param alpha

+	 *            the first angle in degrees

+	 * @param beta

+	 *            the second angle in degrees

+	 * @return this <CODE>Chunk</CODE>

+	 */

+	public Chunk setSkew(float alpha, float beta) {

+		alpha = (float) Math.tan(alpha * Math.PI / 180);

+		beta = (float) Math.tan(beta * Math.PI / 180);

+		return setAttribute(SKEW, new float[] { alpha, beta });

+	}

+

+	/**

+	 * Sets the text horizontal scaling. A value of 1 is normal and a value of

+	 * 0.5f shrinks the text to half it's width.

+	 * 

+	 * @param scale

+	 *            the horizontal scaling factor

+	 * @return this <CODE>Chunk</CODE>

+	 */

+	public Chunk setHorizontalScaling(float scale) {

+		return setAttribute(HSCALE, new Float(scale));

+	}

+

+	/**

+	 * Gets the horizontal scaling.

+	 * 

+	 * @return a percentage in float

+	 */

+	public float getHorizontalScaling() {

+		if (attributes == null)

+			return 1f;

+		Float f = (Float) attributes.get(HSCALE);

+		if (f == null)

+			return 1f;

+		return f.floatValue();

+	}

+

+	/**

+	 * Sets an action for this <CODE>Chunk</CODE>.

+	 * 

+	 * @param action

+	 *            the action

+	 * @return this <CODE>Chunk</CODE>

+	 */

+

+	public Chunk setAction(PdfAction action) {

+		return setAttribute(ACTION, action);

+	}

+

+	/**

+	 * Sets an anchor for this <CODE>Chunk</CODE>.

+	 * 

+	 * @param url

+	 *            the <CODE>URL</CODE> to link to

+	 * @return this <CODE>Chunk</CODE>

+	 */

+

+	public Chunk setAnchor(URL url) {

+		return setAttribute(ACTION, new PdfAction(url.toExternalForm()));

+	}

+

+	/**

+	 * Sets an anchor for this <CODE>Chunk</CODE>.

+	 * 

+	 * @param url

+	 *            the url to link to

+	 * @return this <CODE>Chunk</CODE>

+	 */

+

+	public Chunk setAnchor(String url) {

+		return setAttribute(ACTION, new PdfAction(url));

+	}

+

+	/**

+	 * Sets a local goto for this <CODE>Chunk</CODE>.

+	 * <P>

+	 * There must be a local destination matching the name.

+	 * 

+	 * @param name

+	 *            the name of the destination to go to

+	 * @return this <CODE>Chunk</CODE>

+	 */

+

+	public Chunk setLocalGoto(String name) {

+		return setAttribute(LOCALGOTO, name);

+	}

+

+	/**

+	 * Sets the color of the background <CODE>Chunk</CODE>.

+	 * 

+	 * @param color

+	 *            the color of the background

+	 * @return this <CODE>Chunk</CODE>

+	 */

+	public Chunk setBackground(Color color) {

+		return setBackground(color, 0, 0, 0, 0);

+	}

+

+	/**

+	 * Sets the color and the size of the background <CODE>Chunk</CODE>.

+	 * 

+	 * @param color

+	 *            the color of the background

+	 * @param extraLeft

+	 *            increase the size of the rectangle in the left

+	 * @param extraBottom

+	 *            increase the size of the rectangle in the bottom

+	 * @param extraRight

+	 *            increase the size of the rectangle in the right

+	 * @param extraTop

+	 *            increase the size of the rectangle in the top

+	 * @return this <CODE>Chunk</CODE>

+	 */

+	public Chunk setBackground(Color color, float extraLeft, float extraBottom,

+			float extraRight, float extraTop) {

+		return setAttribute(BACKGROUND, new Object[] { color,

+				new float[] { extraLeft, extraBottom, extraRight, extraTop } });

+	}

+

+	/**

+	 * Sets an horizontal line that can be an underline or a strikethrough.

+	 * Actually, the line can be anywhere vertically and has always the <CODE>

+	 * Chunk</CODE> width. Multiple call to this method will produce multiple

+	 * lines.

+	 * 

+	 * @param thickness

+	 *            the absolute thickness of the line

+	 * @param yPosition

+	 *            the absolute y position relative to the baseline

+	 * @return this <CODE>Chunk</CODE>

+	 */

+	public Chunk setUnderline(float thickness, float yPosition) {

+		return setUnderline(null, thickness, 0f, yPosition, 0f,

+				PdfContentByte.LINE_CAP_BUTT);

+	}

+

+	/**

+	 * Sets an horizontal line that can be an underline or a strikethrough.

+	 * Actually, the line can be anywhere vertically and has always the <CODE>

+	 * Chunk</CODE> width. Multiple call to this method will produce multiple

+	 * lines.

+	 * 

+	 * @param color

+	 *            the color of the line or <CODE>null</CODE> to follow the

+	 *            text color

+	 * @param thickness

+	 *            the absolute thickness of the line

+	 * @param thicknessMul

+	 *            the thickness multiplication factor with the font size

+	 * @param yPosition

+	 *            the absolute y position relative to the baseline

+	 * @param yPositionMul

+	 *            the position multiplication factor with the font size

+	 * @param cap

+	 *            the end line cap. Allowed values are

+	 *            PdfContentByte.LINE_CAP_BUTT, PdfContentByte.LINE_CAP_ROUND

+	 *            and PdfContentByte.LINE_CAP_PROJECTING_SQUARE

+	 * @return this <CODE>Chunk</CODE>

+	 */

+	public Chunk setUnderline(Color color, float thickness, float thicknessMul,

+			float yPosition, float yPositionMul, int cap) {

+		if (attributes == null)

+			attributes = new HashMap();

+		Object obj[] = {

+				color,

+				new float[] { thickness, thicknessMul, yPosition, yPositionMul,

+						(float) cap } };

+		Object unders[][] = addToArray((Object[][]) attributes.get(UNDERLINE),

+				obj);

+		return setAttribute(UNDERLINE, unders);

+	}

+

+	/**

+	 * Utility method to extend an array.

+	 * 

+	 * @param original

+	 *            the original array or <CODE>null</CODE>

+	 * @param item

+	 *            the item to be added to the array

+	 * @return a new array with the item appended

+	 */

+	public static Object[][] addToArray(Object original[][], Object item[]) {

+		if (original == null) {

+			original = new Object[1][];

+			original[0] = item;

+			return original;

+		} else {

+			Object original2[][] = new Object[original.length + 1][];

+			System.arraycopy(original, 0, original2, 0, original.length);

+			original2[original.length] = item;

+			return original2;

+		}

+	}

+

+	/**

+	 * Sets a generic annotation to this <CODE>Chunk</CODE>.

+	 * 

+	 * @param annotation

+	 *            the annotation

+	 * @return this <CODE>Chunk</CODE>

+	 */

+	public Chunk setAnnotation(PdfAnnotation annotation) {

+		return setAttribute(PDFANNOTATION, annotation);

+	}

+

+	/**

+	 * sets the hyphenation engine to this <CODE>Chunk</CODE>.

+	 * 

+	 * @param hyphenation

+	 *            the hyphenation engine

+	 * @return this <CODE>Chunk</CODE>

+	 */

+	public Chunk setHyphenation(HyphenationEvent hyphenation) {

+		return setAttribute(HYPHENATION, hyphenation);

+	}

+

+	/**

+	 * Sets a goto for a remote destination for this <CODE>Chunk</CODE>.

+	 * 

+	 * @param filename

+	 *            the file name of the destination document

+	 * @param name

+	 *            the name of the destination to go to

+	 * @return this <CODE>Chunk</CODE>

+	 */

+

+	public Chunk setRemoteGoto(String filename, String name) {

+		return setAttribute(REMOTEGOTO, new Object[] { filename, name });

+	}

+

+	/**

+	 * Sets a goto for a remote destination for this <CODE>Chunk</CODE>.

+	 * 

+	 * @param filename

+	 *            the file name of the destination document

+	 * @param page

+	 *            the page of the destination to go to. First page is 1

+	 * @return this <CODE>Chunk</CODE>

+	 */

+

+	public Chunk setRemoteGoto(String filename, int page) {

+		return setAttribute(REMOTEGOTO, new Object[] { filename,

+				new Integer(page) });

+	}

+

+	/**

+	 * Sets a local destination for this <CODE>Chunk</CODE>.

+	 * 

+	 * @param name

+	 *            the name for this destination

+	 * @return this <CODE>Chunk</CODE>

+	 */

+	public Chunk setLocalDestination(String name) {

+		return setAttribute(LOCALDESTINATION, name);

+	}

+

+	/**

+	 * Sets the generic tag <CODE>Chunk</CODE>.

+	 * <P>

+	 * The text for this tag can be retrieved with <CODE>PdfPageEvent</CODE>.

+	 * 

+	 * @param text

+	 *            the text for the tag

+	 * @return this <CODE>Chunk</CODE>

+	 */

+

+	public Chunk setGenericTag(String text) {

+		return setAttribute(GENERICTAG, text);

+	}

+

+	/**

+	 * Sets the split characters.

+	 * 

+	 * @param splitCharacter

+	 *            the <CODE>SplitCharacter</CODE> interface

+	 * @return this <CODE>Chunk</CODE>

+	 */

+

+	public Chunk setSplitCharacter(SplitCharacter splitCharacter) {

+		return setAttribute(SPLITCHARACTER, splitCharacter);

+	}

+

+	/**

+	 * Sets a new page tag..

+	 * 

+	 * @return this <CODE>Chunk</CODE>

+	 */

+

+	public Chunk setNewPage() {

+		return setAttribute(NEWPAGE, null);

+	}

+

+	/**

+	 * Sets an arbitrary attribute.

+	 * 

+	 * @param name

+	 *            the key for the attribute

+	 * @param obj

+	 *            the value of the attribute

+	 * @return this <CODE>Chunk</CODE>

+	 */

+

+	private Chunk setAttribute(String name, Object obj) {

+		if (attributes == null)

+			attributes = new HashMap();

+		attributes.put(name, obj);

+		return this;

+	}

+

+	/**

+	 * Gets the attributes for this <CODE>Chunk</CODE>.

+	 * <P>

+	 * It may be null.

+	 * 

+	 * @return the attributes for this <CODE>Chunk</CODE>

+	 */

+

+	public HashMap getAttributes() {

+		return attributes;

+	}

+

+	/**

+	 * Checks the attributes of this <CODE>Chunk</CODE>.

+	 * 

+	 * @return false if there aren't any.

+	 */

+

+	public boolean hasAttributes() {

+		return attributes != null;

+	}

+

+	/**

+	 * Returns the image.

+	 * 

+	 * @return the image

+	 */

+

+	public Image getImage() {

+		if (attributes == null)

+			return null;

+		Object obj[] = (Object[]) attributes.get(Chunk.IMAGE);

+		if (obj == null)

+			return null;

+		else {

+			return (Image) obj[0];

+		}

+	}

+

+	/**

+	 * Checks if a given tag corresponds with this object.

+	 * 

+	 * @param tag

+	 *            the given tag

+	 * @return true if the tag corresponds

+	 */

+

+	public static boolean isTag(String tag) {

+		return ElementTags.CHUNK.equals(tag);

+	}

+

+	/**

+	 * @see com.lowagie.text.MarkupAttributes#setMarkupAttribute(java.lang.String,

+	 *      java.lang.String)

+	 */

+	public void setMarkupAttribute(String name, String value) {

+		if (markupAttributes == null)

+			markupAttributes = new Properties();

+		markupAttributes.put(name, value);

+	}

+

+	/**

+	 * @see com.lowagie.text.MarkupAttributes#setMarkupAttributes(java.util.Properties)

+	 */

+	public void setMarkupAttributes(Properties markupAttributes) {

+		this.markupAttributes = markupAttributes;

+	}

+

+	/**

+	 * @see com.lowagie.text.MarkupAttributes#getMarkupAttribute(java.lang.String)

+	 */

+	public String getMarkupAttribute(String name) {

+		return (markupAttributes == null) ? null : String

+				.valueOf(markupAttributes.get(name));

+	}

+

+	/**

+	 * @see com.lowagie.text.MarkupAttributes#getMarkupAttributeNames()

+	 */

+	public Set getMarkupAttributeNames() {

+		return getKeySet(markupAttributes);

+	}

+

+	/**

+	 * @see com.lowagie.text.MarkupAttributes#getMarkupAttributes()

+	 */

+	public Properties getMarkupAttributes() {

+		return markupAttributes;

+	}

+

+	/**

+	 * Gets the keys of a Hashtable

+	 * 

+	 * @param table

+	 *            a Hashtable

+	 * @return the keyset of a Hashtable (or an empty set if table is null)

+	 */

+	public static Set getKeySet(Hashtable table) {

+		return (table == null) ? Collections.EMPTY_SET : table.keySet();

+	}

+}
\ No newline at end of file