概述
Document是itext的基础,你可以添加文档数据(用户阅读的信息)和元数据(pdf内部使用的信息)。在创建document对象时,你可以定义page size,page color and page margins。
构造函数
查看一下API,Document的构造函数有三个。
其中第一个Document给size,color,margins都设置了默认值。查看源代码,默认为Document(PageSize.A4, 36, 36, 36, 36);
第二个构造函数就可以自定义页面的大小了,例如:
Rectangle rect = new Rectangle(800,600);
Document document = new Document(rect);
Rectangle指定了宽为800,高位600的页面。
Rectangle
在这里有必要看看Rectangle
我们看看一个函数做了什么
/**
* Constructs a <CODE>Rectangle</CODE> -object starting from the origin
* (0, 0).
*
* @param urx
* upper right x
* @param ury
* upper right y
*/
public Rectangle(float urx, float ury) {
this(0, 0, urx, ury);
}
哦,原来是左下角(0,0)为起点,右上角为宽高。如图所示:
当然,通过public Rectangle(float llx, float lly, float urx, float ury)可以随意改变左下角的位置。
/**
* Constructs a <CODE>Rectangle</CODE> -object.
*
* @param llx
* lower left x
* @param lly
* lower left y
* @param urx
* upper right x
* @param ury
* upper right y
*/
public Rectangle(float llx, float lly, float urx, float ury) {
this.llx = llx;
this.lly = lly;
this.urx = urx;
this.ury = ury;
}
Page Size
理论上将,你可以随意的创建页面的大小,但是不同的PDF规范,强制规范了页面的大小。这一点,比较抽象,我就不详细介绍了,具体可以翻阅itext_in_action_2006 2.1.1小结。
Itext提供了一个很实用的类PageSize,它的作用就是返回static final Rectangle对象的集合。提供了标准化的页面大小。例如:
Document document = new Document(PageSize.A4)
横向打印
接下来有个很有趣的函数rotate()。
在打印的时候,经常需要横向打印。有了rotate,这下方便了。
Document document = new Document(PageSize.A4.rotate());
还有Page color和Page Margins,
Rectangle rect = PageSize.A4;
rect.setBackgroundColor(Color.BLUE);
Document document = new Document(rect);
Document document = new Document(PageSize.A4, 36,70, 120, 100);
测试代码
import java.awt.Color;
import java.io.FileOutputStream;
import java.io.IOException;
import com.lowagie.text.Document;
import com.lowagie.text.DocumentException;
import com.lowagie.text.PageSize;
import com.lowagie.text.Paragraph;
import com.lowagie.text.Rectangle;
import com.lowagie.text.pdf.PdfWriter;
import junit.framework.TestCase;
/**
* @blog http://reymont.iteye.com/
* @MSN reymont.li@hotmail.com
* @author reymont.li
* @version create time:2011-7-29 上午10:01:44
*/
public class DocumentStudy extends TestCase{
public void testNewDocumentMargin(){
Document document = new Document(PageSize.A4, 36,70, 120, 100);
try {
PdfWriter.getInstance(
document,
new FileOutputStream("resource/NewDocumentMargin.pdf"));
document.open();
document.add(new Paragraph("Hello World"));
} catch (DocumentException de) {
System.err.println(de.getMessage());
} catch (IOException ioe) {
System.err.println(ioe.getMessage());
}
document.close();
}
public void testNewDocumentColor(){
Rectangle rect = PageSize.A4;
rect.setBackgroundColor(Color.BLUE);
Document document = new Document(rect);
try {
PdfWriter.getInstance(
document,
new FileOutputStream("resource/NewDocumentColor.pdf"));
document.open();
document.add(new Paragraph("Hello World"));
} catch (DocumentException de) {
System.err.println(de.getMessage());
} catch (IOException ioe) {
System.err.println(ioe.getMessage());
}
document.close();
}
public void testNewDocumentRotate(){
Document document = new Document(PageSize.A4.rotate());
try {
PdfWriter.getInstance(
document,
new FileOutputStream("resource/NewDocumentRotate.pdf"));
document.open();
document.add(new Paragraph("Hello World"));
} catch (DocumentException de) {
System.err.println(de.getMessage());
} catch (IOException ioe) {
System.err.println(ioe.getMessage());
}
document.close();
}
public void testNewDocument2(){
Rectangle rect = new Rectangle(500,500,800,600);
Document document = new Document(rect);
try {
PdfWriter.getInstance(
document,
new FileOutputStream("resource/NewDocument2.pdf"));
document.open();
document.add(new Paragraph("Hello World"));
} catch (DocumentException de) {
System.err.println(de.getMessage());
} catch (IOException ioe) {
System.err.println(ioe.getMessage());
}
document.close();
}
public void testNewDocument1(){
Rectangle rect = new Rectangle(0,0,800,600);
Document document = new Document(rect);
try {
PdfWriter.getInstance(
document,
new FileOutputStream("resource/NewDocument1.pdf"));
document.open();
document.add(new Paragraph("Hello World"));
} catch (DocumentException de) {
System.err.println(de.getMessage());
} catch (IOException ioe) {
System.err.println(ioe.getMessage());
}
document.close();
}
public void testNewDocument(){
Rectangle rect = new Rectangle(800,600);
Document document = new Document(rect);
try {
PdfWriter.getInstance(
document,
new FileOutputStream("resource/NewDocument1.pdf"));
document.open();
document.add(new Paragraph("Hello World"));
} catch (DocumentException de) {
System.err.println(de.getMessage());
} catch (IOException ioe) {
System.err.println(ioe.getMessage());
}
document.close();
}
}
参考
IText.Manning.iText.in.Action.Dec.2006.pdf
itext-2.0.8.jar