[iTextSharp学习笔记]使用iText的基本构造块

Chunk（块）

Chunk是添加到Document 对象的用于表示文本的最小对象。Chunk对象包含一个StringBuffer用于存放文本，文本中的字符是相同的字体格式（样式、大小、颜色），这些格式在Font对象中设置。Chunk还可通过成员函数更改其他属性，比如背景色、上（下）标、下划线、删除线等。

作者在第二版《iText in Action》中所用的例子基于一个数据库，为了降低复杂性，本人在学习过程中并未使用该数据库，而是使用一些简单的操作来实践iText的功能。

下面是使用Chunk的一个例子：

 

Document doc = new Document(PageSize.B5);

PdfWriter writer = PdfWriter.GetInstance(doc, new FileStream("F:\\test.pdf", FileMode.Create));

writer.InitialLeading = 30;

doc.Open();

 

doc.Add(new Chunk("China"));

doc.Add(Chunk.NEWLINE);

Font font = new Font(Font.FontFamily.COURIER, 12, Font.BOLD, BaseColor.WHITE);

Chunk content = new Chunk("  BeiJing", font);

content.SetBackground(BaseColor.BLACK, 1F, 1F, 1F, 1F);

content.SetUnderline(1F, -1F); ;

doc.Add(content);

 

doc.Close();

 

作者说，这个例子比较特殊，因为Chunk对象用于组合成其他的对象如Phrase或Paragraph等来表示文字，一般不直接把Chunk对象添加到Document对象中，除了一些特殊的如Chunk.NEWLINE。

行间距（leading）

Chunk 对象并不会自动设置行间距。PdfWriter的setInitialLeading操作用于设置行间距，但在iTextSharp中，通过直接给 PdfWriter的InitialLeading属性赋值来实现。在上面的例子中，如果不设置行间距，两个Chunk对象会写在同一行。

Font对象

iText（包括Chunk对象）默认使用12pt的Helvetica字体，并且这个默认设置不能更改。如果需要使用其他字体的对象，需要创建一个类厂（factory class）来生产使用所需字体的对象。

Font font = new Font(Font.FontFamily.COURIER, 12, Font.BOLD, BaseColor.WHITE);

创建一个Font对象，使用COURIER字体，12号，黑体，白色。

content.SetBackground(BaseColor.BLACK, 1F, 1F, 1F, 1F);

设置字体的背景色为黑色。

doc.Add(content);

 

Phrase（短语）

Phrase对象是带有行间距的Chunk对象的列表。

 

Document doc = new Document(PageSize.B5);

PdfWriter writer = PdfWriter.GetInstance(doc, new FileStream("F:\\test.pdf", FileMode.Create));

doc.Open();

 

Font bold_underlined = new Font(Font.FontFamily.TIMES_ROMAN, 12, Font.BOLD | Font.UNDERLINE);

Font normal = new Font(Font.FontFamily.TIMES_ROMAN, 12);

 

Phrase phrase = new Phrase();

phrase.Leading = 50;

Chunk chunk1 = new Chunk("Hello!", bold_underlined);

Chunk chunk2 = new Chunk("How are you?", normal);

phrase.Add(chunk1);

phrase.Add(Chunk.NEWLINE);

phrase.Add(chunk2);

 

doc.Add(phrase);

Document doc = new Document(PageSize.B5);

PdfWriter writer = PdfWriter.GetInstance(doc, new FileStream("F:\\test.pdf", FileMode.Create));

doc.Open();

 

Font bold_underlined = new Font(Font.FontFamily.TIMES_ROMAN, 12, Font.BOLD | Font.UNDERLINE);

Font normal = new Font(Font.FontFamily.TIMES_ROMAN, 12);

 

Phrase phrase = new Phrase();

Chunk chunk1 = new Chunk("Hello!", bold_underlined);

Chunk chunk2 = new Chunk("How are you?", normal);

phrase.Add(chunk1);

phrase.Add(Chunk.NEWLINE);

phrase.Add(chunk2);

 

doc.Add(phrase);

 

doc.Close();

 

在上面例子中，不需要再给PdfWriter对象设置行间距，Phrase会在两个Chunk对象之间设置默认的行间距。iText中，默认行间距将设置为Phrase或Paragraph中文字的大小的1.5倍。

在iTextSharp中，可对Phrase的Leading属性赋值来设置行间距。

嵌入字体

Font类中可用的字体通常指的是standard type 1字体集。iText并不会将这些字体嵌入到文档中。

Stand type 1字体集曾被称作built-in或Base 14字体集。这些字体并不支持除美国和西欧以外的字符集。如果使用其他字符集，需要通过其他的方法。

使用中文字体

使用BaseFont对象可使iText到指定的位置寻找字体，并明确是否将字体嵌入到文档中。

BaseFont simheiBase = BaseFont.CreateFont(@"C:\Windows\Fonts\simhei.ttf", BaseFont.IDENTITY_H, BaseFont.EMBEDDED);

Font simheiFont = new Font(simheiBase, 12);

如果使用Chunk.NEWLINE换行，iText会使用默认字体，如果使用new Chunk(“\n”,NORMAL)则会使用给Chunk设置的字体。

 

Paragraph对象

Paragraph对象可理解为能进行更多属性设置的Phrase对象和一个换行符。

Paragraph类继承自Phrase类。创建Paragraph实例的方法与创建Phrase实例的方法是一样的。但Paragraph实例可以设置文本对齐方式、缩进以及段前段后空间。

设置对齐方式

设置Alignment属性可以调整Paragraph对象中文字的对齐方式。如：

//设置Paragraph对象的对齐方式为两端对齐

contentPara1.Alignment = Element.ALIGN_JUSTIFIED;

默认情况使用左对齐。

 

设置缩进

iTextSharp中，Paragraph有三个属性可以设置缩进：

//设置Paragraph对象的缩进

contentPara1.IndentationLeft = 20;

contentPara1.IndentationRight = 20;

contentPara1.FirstLineIndent = 20;

IndentationLeft属性设置左侧缩进。

IndentationRight属性设置右侧缩进。

FirstLineIndent属性设置首行左侧缩进。

三个值都可设为正负值。

 

Paragraph之间的间距

iTextSharp中，通过设置Paragraph的SpacingBefore和SpacingAfter属性调整Paragraph对象与之间或之后段落的间距。例如：

//设置Paragraph对象与后面Paragraph对象之间的间距

contentPara1.SpacingAfter = 36;

 

文字分行问题

iText默认的规则是尽可能多的将完整单词放在同一行内。iText当遇到空格或连字符才会分行，可以通过重新定义分隔符（split character）来改变这种规则。

 

分隔符（the split character）

使用nonbreaking space cha