cell.java

iText可以制作中文PDF文件的JAVA源程序

/*
 * $Id: Cell.java,v 1.69 2002/11/19 08:33:32 blowagie 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.Iterator;
import java.util.Properties;

import com.lowagie.text.markup.*;

/**
 * A <CODE>Cell</CODE> is a <CODE>Rectangle</CODE> containing other
 * <CODE>Element</CODE>s.
 * <P>
 * A <CODE>Cell</CODE> must be added to a <CODE>Table</CODE>.
 * The <CODE>Table</CODE> will place the <CODE>Cell</CODE> in
 * a <CODE>Row</CODE>.
 * <P>
 * Example:
 * <BLOCKQUOTE><PRE>
 * Table table = new Table(3);
 * table.setBorderWidth(1);
 * table.setBorderColor(new Color(0, 0, 255));
 * table.setCellpadding(5);
 * table.setCellspacing(5);
 * <STRONG>Cell cell = new Cell("header");</STRONG>
 * <STRONG>cell.setHeader(true);</STRONG>
 * <STRONG>cell.setColspan(3);</STRONG>
 * table.addCell(cell);
 * <STRONG>cell = new Cell("example cell with colspan 1 and rowspan 2");</STRONG>
 * <STRONG>cell.setRowspan(2);</STRONG>
 * <STRONG>cell.setBorderColor(new Color(255, 0, 0));</STRONG>
 * table.addCell(cell);
 * table.addCell("1.1");
 * table.addCell("2.1");
 * table.addCell("1.2");
 * table.addCell("2.2");
 * </PRE></BLOCKQUOTE>
 *
 * @see		Rectangle
 * @see		Element
 * @see		Table
 * @see		Row
 */

public class Cell extends Rectangle implements TextElementArray {

	// static final membervariable

/** This constant can be used as empty cell. */
	public static final Cell EMPTY_CELL = new Cell(true);

/** This constant can be used as empty cell. */
	public static final Cell DUMMY_CELL = new Cell(true);
	static {
		DUMMY_CELL.setColspan(3);
		DUMMY_CELL.setBorder(NO_BORDER);
	}

	// membervariables

/** This is the <CODE>ArrayList</CODE> of <CODE>Element</CODE>s. */
	protected ArrayList arrayList = null;

/** This is the horizontal alignment. */
	protected int horizontalAlignment = Element.ALIGN_UNDEFINED;

/** This is the vertical alignment. */
	protected int verticalAlignment = Element.ALIGN_UNDEFINED;

/** This is the vertical alignment. */
	protected String width;

/** This is the colspan. */
	protected int colspan = 1;

/** This is the rowspan. */
	protected int rowspan = 1;

/** This is the leading. */
	float leading = Float.NaN;

/** Is this <CODE>Cell</CODE> a header? */
	protected boolean header;

/** Will the element have to be wrapped? */
	protected boolean noWrap;

	// constructors

/**
 * Constructs an empty <CODE>Cell</CODE>.
 */

	public Cell() {
		// creates a Rectangle with BY DEFAULT a border of 0.5
		super(0, 0, 0, 0);
		setBorder(UNDEFINED);
		setBorderWidth(0.5f);

		// initializes the arraylist and adds an element
		arrayList = new ArrayList();
	}

/**
 * Constructs an empty <CODE>Cell</CODE> (for internal use only).
 *
 * @param   dummy   a dummy value
 */

	public Cell(boolean dummy) {
		this();
		arrayList.add(new Paragraph(0));
	}

/**
 * Constructs a <CODE>Cell</CODE> with a certain content.
 * <P>
 * The <CODE>String</CODE> will be converted into a <CODE>Paragraph</CODE>.
 *
 * @param	content		a <CODE>String</CODE>
 */

	public Cell(String content) {
		// creates a Rectangle with BY DEFAULT a border of 0.5
		super(0, 0, 0, 0);
		setBorder(UNDEFINED);
		setBorderWidth(0.5f);

		// initializes the arraylist and adds an element
		arrayList = new ArrayList();
		try {
			addElement(new Paragraph(content));
		}
		catch(BadElementException bee) {
		}
	}

/**
 * Constructs a <CODE>Cell</CODE> with a certain <CODE>Element</CODE>.
 * <P>
 * if the element is a <CODE>ListItem</CODE>, <CODE>Row</CODE> or
 * <CODE>Cell</CODE>, an exception will be thrown.
 *
 * @param	element		the element
 * @throws	BadElementException when the creator was called with a <CODE>ListItem</CODE>, <CODE>Row</CODE> or <CODE>Cell</CODE>
 */

	public Cell(Element element) throws BadElementException {
		// creates a Rectangle with BY DEFAULT a border of 0.5
		super(0, 0, 0, 0);
		setBorder(UNDEFINED);
		setBorderWidth(0.5f);

		try {
			Phrase p = (Phrase)element;
			leading = p.leading();
		}
		catch(Exception e) {
			// empty on purpose
		}

		// initializes the arraylist and adds an element
		arrayList = new ArrayList();
		addElement(element);
	}

/**
 * Returns a <CODE>Cell</CODE> that has been constructed taking in account
 * the value of some <VAR>attributes</VAR>.
 *
 * @param	attributes		Some attributes
 */

	public Cell(Properties attributes) {
		this();
		String value;
		if ((value = (String)attributes.remove(ElementTags.HORIZONTALALIGN)) != null) {
			setHorizontalAlignment(value);
		}
		if ((value = (String)attributes.remove(ElementTags.VERTICALALIGN)) != null) {
			setVerticalAlignment(value);
		}
		if ((value = (String)attributes.remove(ElementTags.WIDTH)) != null) {
			setWidth(value);
		}
		if ((value = (String)attributes.remove(ElementTags.COLSPAN)) != null) {
			setColspan(Integer.parseInt(value));
		}
		if ((value = (String)attributes.remove(ElementTags.ROWSPAN)) != null) {
			setRowspan(Integer.parseInt(value));
		}
		if ((value = (String)attributes.remove(ElementTags.LEADING)) != null) {
			setLeading(Float.valueOf(value + "f").floatValue());
		}
		if ((value = (String)attributes.remove(ElementTags.HEADER)) != null) {
			setHeader(new Boolean(value).booleanValue());
		}
		if ((value = (String)attributes.remove(ElementTags.NOWRAP)) != null) {
			setNoWrap(new Boolean(value).booleanValue());
		}
		if ((value = (String)attributes.remove(ElementTags.BORDERWIDTH)) != null) {
			setBorderWidth(Float.valueOf(value + "f").floatValue());
		}
		int border = 0;
		if ((value = (String)attributes.remove(ElementTags.LEFT)) != null) {
			if (new Boolean(value).booleanValue()) border |= Rectangle.LEFT;
		}
		if ((value = (String)attributes.remove(ElementTags.RIGHT)) != null) {
			if (new Boolean(value).booleanValue()) border |= Rectangle.RIGHT;
		}
		if ((value = (String)attributes.remove(ElementTags.TOP)) != null) {
			if (new Boolean(value).booleanValue()) border |= Rectangle.TOP;
		}
		if ((value = (String)attributes.remove(ElementTags.BOTTOM)) != null) {
			if (new Boolean(value).booleanValue()) border |= Rectangle.BOTTOM;
		}
		setBorder(border);
		String r = (String)attributes.remove(ElementTags.RED);
		String g = (String)attributes.remove(ElementTags.GREEN);
		String b = (String)attributes.remove(ElementTags.BLUE);
		if (r != null || g != null || b != null) {
			int red = 0;
			int green = 0;
			int blue = 0;
			if (r != null) red = Integer.parseInt(r);
			if (g != null) green = Integer.parseInt(g);
			if (b != null) blue = Integer.parseInt(b);
			setBorderColor(new Color(red, green, blue));
		}
		else if ((value = (String)attributes.remove(ElementTags.BORDERCOLOR)) != null) {
			setBorderColor(MarkupParser.decodeColor(value));
		}
		r = (String)attributes.remove(ElementTags.BGRED);
		g = (String)attributes.remove(ElementTags.BGGREEN);
		b = (String)attributes.remove(ElementTags.BGBLUE);
		if (r != null || g != null || b != null) {
			int red = 0;
			int green = 0;
			int blue = 0;
			if (r != null) red = Integer.parseInt(r);
			if (g != null) green = Integer.parseInt(g);
			if (b != null) blue = Integer.parseInt(b);
			setBackgroundColor(new Color(red, green, blue));
		}
		else if ((value = (String)attributes.remove(ElementTags.BACKGROUNDCOLOR)) != null) {
			setBackgroundColor(MarkupParser.decodeColor(value));
		}
		if ((value = (String)attributes.remove(ElementTags.GRAYFILL)) != null) {
			setGrayFill(Float.valueOf(value + "f").floatValue());
		}
		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.CELL;
	}

/**
 * Gets all the chunks in this element.
 *
 * @return	an <CODE>ArrayList</CODE>
 */

	public ArrayList getChunks() {
		ArrayList tmp = new ArrayList();
		for (Iterator i = arrayList.iterator(); i.hasNext(); ) {
			tmp.addAll(((Element) i.next()).getChunks());
		}
		return tmp;
	}

	// methods to set the membervariables

/**
 * Adds an element to this <CODE>Cell</CODE>.
 * <P>
 * Remark: you can't add <CODE>ListItem</CODE>s, <CODE>Row</CODE>s, <CODE>Cell</CODE>s,
 * <CODE>JPEG</CODE>s, <CODE>GIF</CODE>s or <CODE>PNG</CODE>s to a <CODE>Cell</CODE>.
 *
 * @param element The <CODE>Element</CODE> to add
 * @throws BadElementException if the method was called with a <CODE>ListItem</CODE>, <CODE>Row</CODE> or <CODE>Cell</CODE>
 */

	public void addElement(Element element) throws BadElementException {
		if (isTable()) {
			Table table = (Table) arrayList.get(0);
			Cell tmp = new Cell(element);
			tmp.setBorder(NO_BORDER);
			tmp.setColspan(table.columns());
			table.addCell(tmp);
			return;
		}
		switch(element.type()) {
			case Element.LISTITEM:
			case Element.ROW:
			case Element.CELL:
				throw new BadElementException("You can't add listitems, rows or cells to a cell.");
			case Element.JPEG:
			case Element.IMGRAW:
			case Element.IMGTEMPLATE:
			case Element.GIF:
			case Element.PNG:
				arrayList.add(element);
				break;
			case Element.LIST:
				if (Float.isNaN(leading)) {
					leading = ((List) element).leading();
				}
				if (((List) element).size() == 0) return;
				arrayList.add(element);
				return;
			case Element.ANCHOR:
			case Element.PARAGRAPH:
			case Element.PHRASE:
				if (Float.isNaN(leading)) {
					leading = ((Phrase) element).leading();
				}
				if (((Phrase) element).isEmpty()) return;
				arrayList.add(element);
				return;
			case Element.CHUNK:
				if (((Chunk) element).isEmpty()) return;
				arrayList.add(element);
				return;
			case Element.TABLE:
				Table table = new Table(3);
				float[] widths = new float[3];
				widths[1] = ((Table)element).widthPercentage();

				switch(((Table)element).alignment()) {
					case Element.ALIGN_LEFT:
						widths[0] = 0f;
						widths[2] = 100f - widths[1];
						break;
					case Element.ALIGN_CENTER:
						widths[0] = (100f - widths[1]) / 2f;
						widths[2] = widths[0];
						break;
					case Element.ALIGN_RIGHT:
						widths[0] = 100f - widths[1];
						widths[2] = 0f;
				}
				table.setWidths(widths);
				Cell tmp;
				if (arrayList.size() == 0) {
					table.addCell(DUMMY_CELL);
				}
				else {
					tmp = new Cell();
					tmp.setBorder(NO_BORDER);
					tmp.setColspan(3);
					for (Iterator i = arrayList.iterator(); i.hasNext(); ) {
						tmp.add((Element) i.next());
					}
					table.addCell(tmp);
				}
				tmp = new Cell();
				tmp.setBorder(NO_BORDER);
				table.addCell(tmp);