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 character,(char)160代替普通空格(char)32放入两个单词中间从而避免iText将它们放到不同行中。