[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