概述
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