用C#製作PDF文件全攻略

PDF文件是目前比較流行的電子文檔格式，在辦公自動化（OA）等軟件的開發中，經常要用到該格式，但介紹如何製作PDF格式文件的資料非常少，在網上搜來搜去，都轉貼的是同一段「暴力」破解的方法，代碼片斷如下：
StreamWriter pPDF=new StreamWriter(filePath);
ArrayList xRefs=new ArrayList();
float yPos =0f;
long streamStart=0;
long streamEnd=0;
long streamLen =0;
string strPDFMessage=null;
//PDF文檔頭信息
strPDFMessage="%PDF-1.1\n";
ConvertToByteAndAddtoStream(strPDFMessage);

xRefs.Add(mPDF.Length);
strPDFMessage="1 0 obj\n";
ConvertToByteAndAddtoStream(strPDFMessage);
strPDFMessage="<< /Length 2 0 R >>\n";
ConvertToByteAndAddtoStream(strPDFMessage);
strPDFMessage="stream\n";
ConvertToByteAndAddtoStream(strPDFMessage);
……
看了上面的製作辦法，我眼鏡都摔壞了三幅，如果用上面這樣原始的辦法能製作出滿意的PDF文件，那一定是天才所為。後來，我從一個網站（網址：http://itextsharp.sourceforge.net/index.html）中看到了專門製作PDF文件的控件的介紹，暗喜之餘，立馬下載試驗，果然非常輕鬆地製作出了想要的PDF文件，因為網站為英文，內容又多，讀起來非常費力，在解決了自己的問題後，看到許多網友還在為PDF文件製作而鬱悶，遂決定將該內容翻譯為中文，由於本人英語水平一般，許多地方又晦澀難懂，故翻譯質量不是很滿意，敬請斧正，但大部分能看懂。本文的目的一是解決部分網友的燃眉之急，二是拋磚引玉，如果哪位仁兄願意將該網站中的內容準確翻譯出來，則是天下之大幸。
要用本文的方法生成PDF文件，需要兩個控件：itextsharp.dll和ICSharpCode.SharpZipLib.dll，由於示例代碼實在太多，我將代碼全部整理出來，放在另外一個文件「示例代碼.doc」中，所有這些資源，我均放在了本人的ftp站點（ftp://202.107.251.26）上的「Pdf文件製作全攻略」文件夾中（文件夾中另外兩個rar壓縮文件為兩個控件的源代碼，供大家學習研究使用），你可以到這裡下載相應的資源，或者直接到原網站下載。
為便於調試和敘述，所有例子均為DOS控制台程序，windows程序使用方法完全一樣，按照下面的步驟創建一個可調試的項目：
1、 打開VS2003；
2、 單擊菜單「文件」→「新建」→「項目」，在項目類型中選擇「Visual C#項目」，在模板中選擇「控制台應用程序」，輸入文件名稱如「MakePdf」，指定好存放路徑，然後點確定按鈕；
3、 在「解決方案資源管理器」中右鍵單擊「引用」，從彈出的菜單中選擇「添加引用」，在「.NET」選項夾中選擇「瀏覽」，添加前面提到的兩個應用，如下圖：

4、 在代碼窗口頂部添加兩個引用：
using iTextSharp.text;
using iTextSharp.text.pdf;
至此，準備工作完畢。

第一部分 iText的簡單應用
第一章 創建一個Document
利用iText五步創建一個PDF文件：helloword。
第一步，創建一個 iTextSharp.text.Document對象的實例：
Document document = new Document();
第二步，為該Document創建一個Writer實例：
PdfWriter.getInstance(document, new FileStream("Chap0101.pdf", FileMode.Create));
第三步，打開當前Document
document.Open();
第四步，為當前Document添加內容：
document.Add(new Paragraph("Hello World"));
第五步，關閉Document
document.Close();
完整的代碼見示例代碼0101。
在例中，不難看出，製作一個PDF文件是非常簡單的。
註：如果你將例中「document.Add(new Paragraph("Hello World"));」中的字符串「Hello Word」換成中文，如「這是我的第一個PDF文件」，產生的結果一定讓你大失所望，因為生成的PDF文件中並沒有將中文顯示出來，不要擔心，在第9章中要專門講解字體問題，中文顯示也就迎刃而解了，如果不能正確顯示中文，也就沒有必要翻譯本文了。
下面對這幾步做詳細介紹。
第一步 創建一個Document實例：
iTextSharp.text.Document-object共有三個構造函數：
public Document();
public Document(Rectangle pageSize);
public Document(Rectangle pageSize,
int marginLeft,
int marginRight,
int marginTop,
int marginBottom);
第一個構造函數以A4頁面作為參數調用第二個構造函數，第二個構造函數以每邊36磅頁邊距為參數調用第三個構造函數
u 頁面尺寸：
你可以通過指定的顏色和大小創建你自己的頁面，示例代碼0102創建一個細長的淺黃色背景的頁面：
Rectangle pageSize = new Rectangle(144, 720);
pageSize.BackgroundColor = new Color(0xFF, 0xFF, 0xDE);
Document document = new Document(pageSize);
通常，你不必創建這樣的頁面，而可以從下面頁面尺寸中選擇：
A0-A10, LEGAL, LETTER, HALFLETTER, _11x17, LEDGER, NOTE, B0-B5, ARCH_A-ARCH_E, FLSA 和 FLSE
大多數情況下使用縱向頁面，如果希望使用橫向頁面，你只須使用rotate()函數：
Document document = new Document(PageSize.A4.rotate());
詳細代碼見示例代碼0103。
u 頁邊距：
當創建一個文件時，你還可以定義上、下、左、右頁邊距：
Document document = new Document(PageSize.A5, 36, 72, 108, 180);
在示例代碼0104中你可以看到該文檔有一個0.5英吋的左邊距和1英吋的右邊距，上邊距為1.5英吋，下邊距為2.5英吋。
說明：
當創建一個矩形或設置邊距時，你可能希望知道該用什麼度量單位：厘米、英吋或象素，事實上，默認的度量系統以排版單位磅為基礎得出其他單位的近似值，如1英吋=72磅，如果你想在A4頁面的PDF中創建一個矩形，你需要計算以下數據：
21 厘米 / 2.54 = 8.2677 英吋
8.2677英吋* 72 = 595 磅
29.7 厘米 / 2.54 = 11.6929 英吋
11.6929英吋* 72 = 842 磅
默認邊距為36磅即半英吋。
如果你修改了頁面尺寸，僅僅影響到下一頁，如果你修改了頁邊距，則影響到全部，故慎用。
關於頁面的初始值，請參考第三步。
第二步 創建Writer實例
一旦創建了document，我們可以創建該文檔的多個Writer的實例，所有這些Writer實例均繼承自抽像類「iTextSharp.text.DocWriter」。
同時還有另外一種情況，你可以用iTextSharp.text.pdf.PdfWriter產生文檔PDF文件，如果你想創建一個TeX文檔，你可以使用iTextSharp.text.TeX.TeXWriter包。
Writer類的構造函數是私有的，你只能通過下面的方法創建一個實例：
public static xxxWriter getInstance(Document document, Stream os);(xxx 是 Pdf 或 Xml)
你可以通過下面的方法創建一個實例：
PdfWriter writer = PdfWriter.getInstance(document, new FileStream("Chap01xx.pdf"));
但是你幾乎永遠不會用到Writer實例（除非你想創建高級PDF或者希望用一些非常特殊的函數，如ViewerPreferences 或 Encryption）。所以通過下面的辦法得到實例已經足夠了： PdfWriter.getInstance(document, new FileStream("Chap01xx.pdf"));
在第一步中創建一個文檔時，第一個參數意義不大，第二個參數可以是任何一種流，到目前為止我們一直使用System.IO.FileStream將Document寫入文件中，示例代碼0105用到了System.IO.MemoryStream（這不是一個獨立的例子，你必須在Servlet Engine中測試這些代碼。
第三步 打開Document
u 摘要
在你寫入任何實際數據之前，你可能希望通過以下幾種方法寫入一些關於本文檔的摘要：
public boolean addTitle(String title)
public boolean addSubject(String subject)
public boolean addKeywords(String keywords)
public boolean addAuthor(String author)
public boolean addCreator(String creator)
public boolean addProducer()
public boolean addCreationDate()
public boolean addHeader(String name, String content)
你可以選擇自己的標題、主題、關鍵字、作者、創建程序，但以下產品信息將始終被添加：iTextSharp (或者iTextSharp的引用)和創建時間（實際上這兩種方法是自動調用的）。
你還可以將自定義的名稱添加為「報頭信息」，但是這對於PdfWriter沒有任何作用，如果看看實例代碼0101產生的pdf文件的「文檔屬性」，我們可以看到僅僅有PDF創建程序和產品日期，而示例代碼0106的「文檔屬性」框中有更多的信息。

打開document前要做的事：
你只能在Open方法調用之前添加摘要，這是iText開發工具提供的一個選擇。
在HTML中，報頭信息被放在文檔前面報頭標識中間，調用Open方法將導致報頭信息寫入流，因而在Document被打開後無法更改這些數據。
PDF報頭信息不包括摘要，看起來有類似於：
%PDF-1.2
該行顯示生成的文檔是一個版本為1.2的PDF格式的文件，在PDF中，摘要保存在PdfInfo對像中，當文檔關閉時已經寫入PdfWriter中了，因此，沒有關於為什麼不能修改庫來滿足任何時候添加或更改摘要的技術原因
u 頁面初始化
Open方法在不同的Witer中同時會產生初始化事件，舉例來說，如果你需要一個水印或者頁眉頁角對像出現在文檔第一頁的開始處，你需要在打開文檔前添加這些，同樣的用於設置該文檔其他頁水印、頁眉、頁角、頁數和尺寸。
當調用下列方法：
public bool setPageSize(Rectangle pageSize)
public bool Add(Watermark watermark)
public void removeWatermark()
setting Header property
public void resetHeader()
setting Footer property
public void resetFooter()
public void resetPageCount()
setting PageCount property
產生的結果只能在下一個新頁中看到（當在本頁調用初始化方法時），代碼見示例代碼0107，你必須要準備一張名為watermark.jpg的圖片，如下圖：

u 閱讀器參數：
你可以通過下面的辦法為PDF文件指定一些閱讀器 (如Adobe Reader) 參數：
public void setViewerPreferences(int preferences)
在示例代碼0108中，指定了下面一些參數：
writerA.setViewerPreferences(PdfWriter.PageLayoutTwoColumnLeft);
writerB.setViewerPreferences(PdfWriter.HideMenubar | PdfWriter.HideToolbar);
writerC.setViewerPreferences(PdfWriter.PageLayoutTwoColumnLeft | PdfWriter.PageModeFullScreen | PdfWriter.NonFullScreenPageModeUseThumbs);
正如你所看到的，參數可以使用以下一些常量：
l 文件被打開時，頁面佈局用到下面的其中一個 ：
PdfWriter.PageLayoutSinglePage – 同時只顯示一個頁面
PdfWriter.PageLayoutOneColumn –單列顯示
PdfWriter.PageLayoutTwoColumnLeft –雙列顯示,奇數頁在左
PdfWriter.PageLayoutTwoColumnRight -雙列顯示,奇數頁在右
l 文件打開時，頁面模式用到下面其中之一：
PdfWriter.PageModeUseNone – 既不顯示大鋼也不顯示縮略圖
PdfWriter.PageModeUseOutlines – 顯示大綱
PdfWriter.PageModeUseThumbs – 顯示縮略圖
PdfWriter.PageModeFullScreen – 全屏模式，沒有菜單、windows控件或者其他任何windows可見控件
l PdfWriter.HideToolbar – 當文檔激活時，是否隱藏閱讀程序（如Adobe Reader）的工具條
l PdfWriter.HideMenubar -當文檔激活時，是否隱藏閱讀程序的菜單.
l PdfWriter.HideWindowUI -當文檔激活時，是否隱藏閱讀程序的界面元素，如滾動條、導航條等，而僅僅保留文檔顯示
l PdfWriter.FitWindow – 是否調整文檔窗口尺寸以適合顯示第一頁。
l PdfWriter.CenterWindow – 是否將文檔窗口放到屏幕中央
l 在全屏模式下，指定如何顯示界面元素（選擇一個）
PdfWriter.NonFullScreenPageModeUseNone -既不顯示大鋼也不顯示縮略圖
PdfWriter.NonFullScreenPageModeUseOutlines – 顯示大鋼
PdfWriter.NonFullScreenPageModeUseThumbs – 顯示縮略圖
說明:你只能在類PdfWriter中調用這些方法。
u 加密
打開文檔之前還要做的一件事情就是加密（如果你希望該文檔加密），要達到這個目的，你可以使用下面的方法：
public void setEncryption(boolean strength, String userPassword, String ownerPassword, int permissions);
strength 是下面兩個常量之一：
PdfWriter.STRENGTH40BITS: 40 位
PdfWriter.STRENGTH128BITS: 128位 (Acrobat Reader 5.0及以上版本支持)
UserPassword和ownerPassword 可以為空或零長度， 這種情況下， ownerPassword 將被隨機的字符串代替
Permissions 為下列常量之一：
PdfWriter.AllowPrinting
PdfWriter.AllowModifyContents
PdfWriter.AllowCopy
PdfWriter.AllowModifyAnnotations
PdfWriter.AllowFillIn
PdfWriter.AllowScreenReaders
PdfWriter.AllowAssembly
PdfWriter.AllowDegradedPrinting
該功能參見示例代碼0109和示例代碼0110。
writer.setEncryption(PdfWriter.STRENGTH40BITS, null, null, PdfWriter.AllowCopy);
示例代碼0109產生的文件能夠被打開而無須密碼，但用戶不能打印、修改本文檔。
writer.setEncryption(PdfWriter.STRENGTH128BITS, "userpass", "ownerpass", PdfWriter.AllowCopy | PdfWriter.AllowPrinting);
打你試圖打開示例代碼0110產生的文件時，將要求輸入密碼（'userpass'），因為添加了AllowPrinting參數,你可以打印該文檔而不會發生任何問題。
第四步 添加內容
在解釋第一步到第三步的不同示例中，你可能已經遇到了一些對像如Phrase, Paragraph等 在接下來的幾章中，所有這些問題都將得到詳細解釋。
有時你可能想一個writer故意忽略document產生的行為，如示例代碼0111：
當我們創建了兩個writer： writerA 和 writerB：
PdfWriter writerA = PdfWriter.getInstance(document, new FileStream("Chap0111a.pdf", FileMode.Create));
PdfWriter writerB = PdfWriter.getInstance(document, new FileStream("Chap0111b.pdf", FileMode.Create));
我們可以創建兩個有細微差別的文檔：
writerA.Pause();
document.add(new Paragraph("This paragraph will only be added to Chap0111b.pdf, not to Chap0111a.pdf"));
writerA.resume();
你可以比較文件: Chap0111a.pdf和Chap0111b.pdf的區別
第五步，關閉 document
關閉 document 非常重要, 因為它將關閉正在運行的Writer並將內容寫入文件，該方法在最後被調用，你應該總是要關閉文檔。
高級話題：閱讀PDF文件
該部分內容介紹了iText只能產生PDF格式的文件而不能解析PDF格式文件，不再翻譯。
第二章 塊、短句和段落
塊
塊(Chunk)是能被添加到文檔的文本的最小單位，塊可以用於構建其他基礎元素如短句、段落、錨點等，塊是一個有確定字體的字符串，要添加塊到文檔中時，其他所有佈局變量均要被定義。下面一行中，我們創建了一個內容為「hello World」、紅色、斜體、COURIER字體、尺寸20的一個塊：
Chunk chunk = new Chunk("Hello world", FontFactory.getFont(FontFactory.COURIER, 20, Font.ITALIC, new Color(255, 0, 0)));
u 典型字體1：
在本指南中，除了第九章外（你可以在這裡學會使用其他字體），我們將始終使用典型字體1，這些是不同的典型字體1：
· Courier (該字體定寬)
· Helvetica
· Times Roman
· Symbol
· ZapfDingbats

u 下劃線/刪除線
如果你希望一些塊有下劃線或刪除線，你可以通過改變字體風格簡單做到：
Chunk chunk1 = new Chunk("This text is underlined", FontFactory.getFont(FontFactory.HELVETICA, 12, Font.UNDERLINE));
Chunk chunk2 = new Chunk("This font is of type ITALIC | STRIKETHRU", FontFactory.getFont(FontFactory.HELVETICA, 12, Font.ITALIC | Font.STRIKETHRU));
u 上標/下標
在塊中有幾個方法可以調用，其中大部分將在接下來的章節中介紹，本章中只介紹一個方法 setTextRise(float f). 你可以使用該方法在上標或下標中寫塊。
u 塊的背景
如果你想改變塊的背景，你可以使用方法setBackground(Color color). 這將在塊文本的下面添加一個彩色矩形：
ck.setBackground(new Color(0xFF, 0xFF, 0x00));
在示例代碼0101中，你可以概覽典型字體1和一個使用setTextRise, setBackground等方法的的例子。
短句
短句（Phrases）是一系列以特定間距（兩行之間的距離）作為參數的塊，一個短句有一個主字體，但短句中的一些塊具有不同於主字體的字體，你有更多的選擇去創建短句，一些具體使用參見代碼0202。

u 古希臘語
因為古希臘語經常使用，在類Phrase的構造函數中有一個特徵：將一個字符串作為參數（如果你想避免這種情況，你只能使用塊工作而不能使用字符串），正如你在示例代碼0203中看到的，這個特徵自動地將913至937（除903）和945至969（古希臘的ASCII值）範圍內的所有字體改為希臘符號。
u 非主要性
與其說這是一個特徵，不如說是一個缺陷，但無論如何，這使創建一個非主要性的短句或段落成為可能，這將產生一個由下向上書寫的臨時作用（參見示例代碼0204）。如果你想在一頁中將一些位置移動到上面時可能有用。
說明，當你穿越上邊屆時無法檢查，也沒有辦法讓你回到前一頁。
段落
段落是一系列塊和（或）短句。同短句一樣，段落有確定的間距。用戶還可以指定縮排；在邊和（或）右邊保留一定空白，段落可以左對齊、右對齊和居中對齊。添加到文檔中的每一個段落將自動另起一行。有幾種辦法建立一個段落，如：
Paragraph p1 = new Paragraph(new Chunk("This is my first paragraph.", FontFactory.getFont(FontFactory.HELVETICA, 12)));
Paragraph p2 = new Paragraph(new Phrase("This is my second paragraph.", FontFactory.getFont(FontFactory.HELVETICA, 12)));
Paragraph p3 = new Paragraph("This is my third paragraph.", FontFactory.getFont(FontFactory.HELVETICA, 12));
所有有些對像將被添加到段落中：
p1.add("you can add strings, "); p1.add(new Chunk("you can add chunks ")); p1.add(new Phrase("or you can add phrases."));
說明：一個段落有一個且僅有一個間距，如果你添加了一個不同字體的短句或塊，原來的間距仍然有效，你可以通過SetLeading來改變間距，但是段落中所有內容將使用新的中的間距。見示例代碼0205。
u 保持段落的整體性
在示例代碼0206中，我們使用了setKeepTogether(true)方法來試圖將一個段落放在同一頁中，該方法並不是始終有效，舉個例子，第一段不能剛好在一頁中，於是被分成了兩部分。第二段被放置在第二頁，但第三段順沿到了第三頁上。
字體的延續
你應該掌握字體延續的一些規則，這些規則的應用見示例代碼0207，當我們將一些內容用指定的字體（非默認字體）創建一個短句或者段落後再添加更多內容時，初始對象的字體風格將被延續，請看「Hello 1!」和「Hello 2」：
Phrase myPhrase = new Phrase("Hello 2! ", new Font(Font.TIMES_NEW_ROMAN, 8, Font.BOLD));
myPhrase.Add(new Phrase("some other font ", new Font(Font.HELVETICA, 8, Font.ITALIC)));
myPhrase.Add(new Phrase("This is the end of the sentence.\n", new Font(Font.TIMES_NEW_ROMAN, 8, Font.ITALIC)));
document.Add(myPhrase);
我們由Times New Roman 粗體字開始，添加一些文本使用Helvetica字體而不指定風格，我們發現文本被改變成了粗體，當我們再加一些文本使用Times New Roman字體和斜體風格，結果變成了粗斜體。
如果我們使用FontFactory來創建字體，字體風格不會被延續，因為FontFactory使用了另外的技術構建一個字體：
myPhrase = new Phrase("Hello 1bis! ", FontFactory.getFont(FontFactory.TIMES_NEW_ROMAN, 8, Font.BOLD));
myPhrase.Add(new Phrase("some other font ", FontFactory.getFont(FontFactory.HELVETICA, 8, Font.ITALIC)));
myPhrase.Add(new Phrase("This is the end of the sentence.\n", FontFactory.getFont(FontFactory.TIMES_NEW_ROMAN, 8, Font.ITALIC)));
document.Add(myPhrase);
在上面的代碼中，使用Helvetica字體的文本風字體沒有指定（既不是粗體也不是斜體）。採用Times New Roman的額外文本僅僅顯示為斜體。
你也看到我們添加了一個段落，添加該段落就如同一個短句。
Paragraph myParagraph = new Paragraph("Hello 1! ", new Font(Font.TIMES_NEW_ROMAN, 8, Font.BOLD));
myParagraph.Add(new Paragraph("This is the end of the sentence.",FontFactory.getFont(new Font.TIMES_NEW_ROMAN, 8)));
document.Add(myParagraph);
你可以不這樣做，但將失去字體風格的延續，首先不用任何字體創建段落（例中我們僅僅給字體出間距為1.5倍），然後添加內容的不同部分。

myParagraph = new Paragraph(12);
myParagraph.Add(new Paragraph("Hello 3! ", new Font(Font.TIMES_NEW_ROMAN, 8, Font.BOLD)));
myParagraph.Add(new Paragraph("This is the end of the sentence.", new Font(Font.TIMES_NEW_ROMAN, 8, Font.ITALIC)));
document.Add(myParagraph);
如果你使用了Phrase對象，你同樣會失去字體風格的延續：
myPhrase = new Phrase(12);
myPhrase.Add(new Phrase("Hello 4! ", new Font(Font.TIMES_NEW_ROMAN, 8, Font.BOLD)));
myPhrase.Add(new Phrase("This is the end of the sentence.", newFont(Font.TIMES_NEW_ROMAN, 8, Font.ITALIC)));
document.Add(myPhrase);
u 更改分割符
通常，當文本不能放在一行時，文本將被分割成不同的部分，iText首先會查找分割符，如果沒有找到，文本將在行尾被截斷。有一些預定的分割符如「 」空格和「-」連字符，但是你可以使用setSplitCharacter方法來覆蓋這些默認值。在示例代碼0208中，你可以看到當到達行尾時一個塊是如何被分割的。然後分隔符被改成點「.」，該行在該字符處被分割。
第三章 錨點、列表和註釋
錨點
我們都知道HTML中的超文本鏈接，當我們點擊某些語句，你能夠跳轉到網上的其他頁。在PDF中也可以實現這種功能。事實上，在第十一章整個章節中有關於PDF鏈接的介紹，但這是iText的更高級的應用，本章中我們處理簡單的iText。
如果你想在文檔中添加一個外部鏈接（例如使用URL鏈接到WEB上的其他文檔），你可以簡單地使用Anchor對象，它派生於Phrase對象，使用方法相同。只有兩種額外方法定義兩種額外變量：setName和 setReference。
外部鏈接示例：
Anchor anchor = new Anchor("website", FontFactory.getFont(FontFactory.HELVETICA, 12, Font.UNDERLINE, new Color(0, 0, 255)));
anchor.Reference = "http://itextsharp.sourceforge.net";
anchor.Name = "website";
如果你想添加內部鏈接，你需要選擇該鏈接不同的名稱，就像你相位在HTML中利用名稱作為錨點一樣。為達到該目的，你需要添加一個「#」。
內部鏈接示例：
Anchor anchor1 = new Anchor("This is an internal link");
anchor1.Name = "link1";
Anchor anchor2 = new Anchor("Click here to jump to the internal link");
anchor.Reference = "#link1";
這兩個鏈接的例子請見示例代碼0301。
列表
通過類List 和ListItem，你可以添加列表到PDF文件中，對於列表你還可以選擇是否排序。
排序列表示例：
List list = new List(true, 20);
list.Add(new ListItem("First line"));
list.Add(new ListItem("The second line is longer to see what happens once the end of the line is reached. Will it start on a new line?"));
list.Add(new ListItem("Third line"));
結果如下：
First line
The second line is longer to see what happens once the end of the line is reached. Will it start on a new line?
Third line
不排序示例如下：
List overview = new List(false, 10);
overview.Add(new ListItem("This is an item"));
overview.Add("This is another item");
結果如下：
This is an item
This is another item
你可以通過setListSymbol方法更改列表符號：
// 用字符串作為列表符號
list1.ListSymbol = "*";
// 用Chunk 作為列表符號（包含「&#8226;」字符）
list2.ListSymbol = new Chunk("\u2022", FontFactory.getFont(FontFactory.HELVETICA, 20));
//用圖片作為列表符號
list3.ListSymbol = new Chunk(Image.getInstance("myBullet.gif"), 0, 0);
還可以使用setIndentationLeft和setIndentationRight方法設置縮排，列表符號的縮排在構造函數中設置。更多的例子請參見示例代碼0302。
註釋
iText支持不同風格的註釋。
u 文本註釋：
你可以添加一小段文本到你的文檔中，但它並非文檔內容的一部分，註釋有標題和內容：
Annotation a = new Annotation(
"authors",
"Maybe it's because I wanted to be an author myself that I wrote iText.");
u 外部鏈接註釋：
你需要指定一個可點擊的矩形和一個字符串（URL描述）或URL對像：
Annotation annot = new Annotation(100f, 700f, 200f, 800f, new URL("http://www.lowagie.com"));
Annotation annot = new Annotation(100f, 700f, 200f, 800f, "http://www.lowagie.com");
u 外部PDF文件鏈接註釋：
你需要指定一個可點擊的矩形和一個字符串（文件名稱）和目的文件或頁碼。
Annotation annot = new Annotation(100f, 700f, 200f, 800f, "other.pdf", "mark");
Annotation annot = new Annotation(100f, 700f, 200f, 800f, "other.pdf", 2);
u 指定行為鏈接註釋
你需要指定一個可點擊的矩形和一個指定的行為：
Annotation annot = new Annotation(100f, 700f, 200f, 800f, PdfAction.FIRSTPAGE);
u 應用程序鏈接註釋：
你需要指定一個可點擊的矩形和一個應用程序：
Annotation annot = new Annotation(300f, 700f, 400f, 800f, "C://winnt/notepad.exe", null, null, null);
我們無須在頁面上指定一個位置，iText會內部處理。你能夠看到iText添加文本註釋在頁面上當前位置下面，第一個在段後第一行下面，第二個在短句結束處的下面。
所有其他註釋需要指定想匹配的矩形區域，在示例代碼0304中，我們畫了一些正方形（使用的函數將在第十章中介紹），為每個正方形添加了一些鏈接註釋。
第四章 頁眉頁腳、章節、區域和繪圖對像
使用在第三至第五章中描述的大量簡單iText對象可以避免更多的高級話題（第九至十二章），緊記這些簡單對像限制的功能，大量複雜的功能在第三部分。
頁眉頁腳
HeaderFooter對象可以於為文檔每頁添加頁眉和頁腳。這樣一個頁眉或頁腳包含一個標準的短句（如果需要）和當前頁碼，如果你需要更多複雜的頁眉和頁腳（使用表格或者第幾頁共幾頁），請閱讀第十二章。
在示例代碼0401中，你可以看到我們首先添加了一個包含頁碼沒有任何邊框的頁腳。
HeaderFooter footer = new HeaderFooter(new Phrase("This is page: "), true);
footer.Border = Rectangle.NO_BORDER;
document.Footer = footer
我們還可以使用下面的構造函數：
HeaderFooter footer = new HeaderFooter(new Phrase("This is page "), new Phrase("."));
構造函數知道你希望添加一個頁碼和將其放置在兩個短句間，如果你只是設置一個HeaderFooter而不改變邊框，頁眉或頁腳的文本上下各有一條直線。
HeaderFooter header = new HeaderFooter(new Phrase("This is a header without a page number"), false);
document.Header = header;
章節和區域
在第十一章中將描述如何構建一個樹的外觀，如果你只需要一個簡單的章節和（子）區域，你可以用Chapter對像和Section對像自動構建一個樹：
Paragraph cTitle = new Paragraph("This is chapter 1", chapterFont);
Chapter chapter = new Chapter(cTitle, 1);
Paragraph sTitle = new Paragraph("This is section 1 in chapter 1", sectionFont);
Section section = chapter.addSection(sTitle, 1);
在示例代碼0402中，我們添加了一系列的章節和子區域，你可以看到完整的樹形，樹形結構默認打開，如果你希望部分節點關閉，你必須使用用BookmarkOpen屬性其值為false，詳見示例代碼0403。
圖形
如果你想添加圖形，如直線、圓、幾何窗體，你應該閱讀讀十章，但如果你只需要一些有限的功能，你可以使用Graphic對像
Graphic grx = new Graphic();
//添加一個矩形
grx.rectangle(100, 700, 100, 100);
// 添加一條斜線
grx.moveTo(100, 700);
grx.lineTo(200, 800);
// 將圖形顯示出來
grx.stroke();
document.Add(grx);
完整的代碼請見示例代碼0404，如果想看到全部的方法，請參見PdfContentByte對像API。
當你想給頁面加一個邊框或者在文本當前位置畫一條水平線時，圖形對像非常有用。下面的方法用指定的寬度、間距（如果需要）和顏色畫一個邊框。
public void setBorder(float linewidth, float extraSpace);
public void setBorder(float linewidth, float extraSpace, Color color);
下面的方法用指定的寬度（如果需要）和顏色畫一條水平線，線的長度是指定兩邊緣間可用面積的的百分比。
public void setHorizontalLine(float linewidth, float percentage)
public void setHorizontalLine(float linewidth, float percentage, Color color)
示例代碼5中，有一個離邊界5磅，線寬3磅的邊框，還有兩條水平線，一條為黑色，5磅寬，可用空間的100％，另外一條為紅色，線寬3磅，可用空間的80％。
第五章 表格
重點：如果你僅僅生成PDF文件（沒有XML、HTML、RTF……），使用類pdfPTable代替類Table更好。
一些簡單的表格
一個表格是包含單元格排列成矩陣的矩形區域。表格的距陣並不要求是m×n的，它可以有空洞或者單元格比單個的要大。
創建一個表格最通用的辦法是預先知道有幾行幾列：
public Table(int columns, int rows);
在示例代碼0501中，我們構建了一個簡單的表：
Table aTable = new Table(2,2);
aTable.addCell("0.0");
aTable.addCell("0.1");
aTable.addCell("1.0");
aTable.addCell("1.1");
該表格有兩行兩列，單元格被自動添加，從第一行第一列開始，然後是第二列，當一行滿後，下一單元格自動添加到下一行的第一列中。
也可以將單元格添加到表中指定的位置，如示例代碼0502，別了要添加System.Drawing.dll引用，以獲得Point對象，我們創建了一個4行4列的表格然後添加一些單元格到隨機的位置上：
Table aTable = new Table(4,4);
aTable.AutoFillEmptyCells = true;
aTable.addCell("2.2", new Point(2,2));
aTable.addCell("3.3", new Point(3,3));
aTable.addCell("2.1", new Point(2,1));
aTable.addCell("1.3", new Point(1,3));
你可以看到我們將AutoFillEmptyCells屬性設置為true，這將自動、默認的單元格佈局填充空的單元格，如果我們忘記了這樣做（就像本例中第二個表格），將沒有額外的單元格添加，不包含任何單格的行也將被忽略，在本例中，第一行將不顯示，因為該行是空行。
經常用數據庫查詢結果來填充表格，大多數情況下，你預先並不知道到底需要多少行，這就是為什麼還有第二個構造函數的原因：
public Table(int columns);
iText根據需要自動添加行，在示例代碼0503中，初始化了4行4列，當我們添加第6行和第7行的單元格時，iText自動增加行數到7。
增加列數也是可能的，但是有點麻煩，它不能自動生成，你必須使用addColumns方法並設置列寬，詳見示例代碼0504。
一些表格參數
前面例子中的表格並不美觀，我們可以設置大量的參數來改變表格外觀。類Table和類Cell派生於類Rectangle，我們可以用大量典型的Rectangle方法，讓我們來看看示例代碼0505。
Table table = new Table(3);
table.BorderWidth = 1;
table.BorderColor = new Color(0, 0, 255);
table.Cellpadding = 5;
5. table.Cellspacing = 5;
Cell cell = new Cell("header");
cell.Header = true;
cell.Colspan = 3;
table.addCell(cell);
10. cell = new Cell("example cell with colspan 1 and rowspan 2");
cell.Rowspan = 2;
cell.BorderColor = new Color(255, 0, 0);
table.addCell(cell);
table.addCell("1.1");
15. table.addCell("2.1");
table.addCell("1.2");
table.addCell("2.2");
table.addCell("cell test1");
cell = new Cell("big cell");
20. cell.Rowspan = 2;
cell.Colspan = 2;
cell.BackgroundColor = new Color(0xC0, 0xC0, 0xC0);
table.addCell(cell);
table.addCell("cell test2");
25. document.Add(table);

u 單元格間距和填距
在第4行中，我們設置了表格的填距，就是單元格邊界和內容間一定數量的空間，在前面的示例中，我們看到文本緊貼邊界，通過使用用特定的填距，就可以避免。
在第5行中，我們設置了表格的間距，就是單元格和表格邊界間的一定數量的空間，不同的單元格間使用了半數空間，具體代碼見示例代碼0506。
u 對齊方式
在示例代碼0506中，我們也改變了單元格「big cell」的對齊方式：
cell.HorizontalAlignment = Element.ALIGN_CENTER;
cell.VerticalAlignment = Element.ALIGN_MIDDLE;
註：不能總是相信垂直對齊方式。
u 邊框
如果我們像在第14行中那樣添加了一個單元格，將使用默認的單元格佈局（默認的佈局可以SetDefalut方法改變），如果我們使用了Cell對象，我們可以控制每一個單元格的佈局。
在第2和第三中，我們設置整個表格的邊框寬度和邊框顏色，我們在單元格上可以使用的方法，在12行中，每個單元格用「box」作為邊界繪製（就像在HTML中），但是示例代碼0507顯示，我們在PDF中有大量更多可能。
u 顏色
在第22行中，你也能定義單元格的背景色，在示例代碼0507中，我們不使用顏色只是用一定灰度填充。
u 行跨和列跨
最後，你也能設置單元格的行跨（11/20行）和列跨（8/21列）。通過這種方法可以將幾個單元格合併成一個大的單元格。
u 備註
第7行在PDF中沒有意義，用於生成HTML，在HTML中並不是總能產生同樣的佈局，PDF表格有點像：

header
example cell with colspan 1 and rowspan 2
1.1
2.1
1.2
2.2
cell test1
big cell
cell test2

 

 

 

 

 

 

u 表格分割
如果一個表格不能放在一頁中，將自動被分割，示例代碼0508顯示了當一個表格到達頁邊時發生的情況，這將在下一節中解釋。
大表格
跨越幾頁的表格將自動被分割成不同的部分。示例代碼0509顯示了一個跨越多頁的報表。該報表有一個表頭，如果你希望這個表頭在每頁都出現，你可以用endHeaders()方法標記表頭區域的結束點，見示例代碼0510。
為做這樣的報表，建議設置單元格間距為0和僅使用指定的填距。
你可能已經注意到了，當一個表格被分割時，一些邊界好像丟失了。這是因為單元格在前一頁被完整地繪製了而不會傳遞給下一頁。
u 強行將一個表格或單元格佈置到一頁上
有有些情況下，你可能希望避免單元格或者整個表被拆分成兩個部分，示例代碼0511差不多和示例代碼0508完全一樣，但我們設置了參數TableHasToFit為true，看看示例代碼0508和示例代碼0511結果區別。在示例代碼0512中我們修改了示例代碼0510的CellsHaveToFit屬性為true，比較兩個示例產生結果的區別。
內存管理
當我們添加一個對像到文檔時，該對像一有可能就寫入了輸出流，但當創建一個表格時，該Table對像一直保存著，對於真正的大表格，這將成為一個問題。
同樣，當你正寫一個HttpServletResponse對像到輸出流時，瀏覽器也可能超時。這就是為什麼你自己用fitsPage()方法控制表分割是有用的，示例代碼0513告訴你如何做。
嵌套表格
有兩種方法嵌套表格，第一種是利用insertTable方法明確地將一個表格插入到另外一個表格，示例代碼0514顯示了通過插入到其他表格的辦法創建的5個表格。正如你看到的在前面兩個表中，所有空的單元格自動得到分割，因為改變了原來的表格。如果一個單元格不空，列跨度和（或）行跨度將自動調整到新的位置，頁面上第三個表格顯示所有原表中列的相關寬度都得到了保護，第四個表格顯示我們可以在插入了表格後添加其他單元格：該單元格自由地添加到下一個單元格中。最後是一個深度嵌套的表格。
當你使用insertTable方法時，插入表的寬度百分比不會被考慮，如果你希望插入表僅佔單元格的80％（這是默認的寬度百分比），你不得不在單元格中繞排，見示例代碼0515，這也是讓一個表結合其他數據存放在同一個單元格中的唯一辦法，見示例代碼0516。
備註：你只能將一個表格插入到列跨度和行跨度均為1的單元格中。
表格偏移
當一個表格被添加到文檔之前，以當前間距為準的新行將被添加（如前一個插入對象的間距）。有時因為前一個插入對像和當前表格間的間距過大或過小你並不希望這樣做，如果你想改變這個空間，你不得不設置表格偏移，如示例代碼0517。
表格的絕對位置
iTextSharp.text.Table是一個通過標準方法創建表格的相當簡單的類，但有時你希望表格有一些特殊的行為，這種情況下你將使用更複雜的類com.lowagie.text.pdf.PdfPTable，示例代碼0518是一個非常簡單的例子，在第十章和十二章中將有一些更複雜的例子。
第六章 圖片
Image對像
如果你學習過API，你可能已經注意到可以通過幾種構造函數來創建圖片，本手冊中，我們將僅僅告訴你最簡單的解決方案，如訪問通過文件名或URL確定的圖片生成的Image對象。
public static Image getInstance(Uri url)
public static Image getInstance(string filename)
Image是一個抽像類，故得到實例的方法將判斷給出的圖片的類別（GIF、Jpeg、PNG……）並返回對象的類別Gif、Jpeg、Png……，一些圖片會被忽略，如果你想知道哪些圖片會被忽略，請查閱FAQ（http://www.lowagie.com/iText/faq.html#images）。
u 通過URL得到圖片實例
這是添加一個圖片最簡單的辦法，見示例代碼0601，我們添加了一個WMF、一個Gif、一個Jpeg和一個PNG圖片到文檔中，使用4個URL得到：
Image wmf = Image.getInstance(new URL("../examples/harbour.wmf"));
Image gif = Image.getInstance(new URL("../examples/vonnegut.gif"));
Image jpeg = Image.getInstance(new URL("../examples/myKids.jpg"));
Image png = Image.getInstance(new URL("../examples/hitchcock.png"));
備註：許多PDF庫在插入一個圖片前都將其解壓縮並轉換成位圖格式，下面是幾個我為什麼不這樣做的原因：
這將導致PDF文件增大，這樣產生的PDF文件尺寸是不同圖片文件尺寸總和的數十倍。
面臨一個法律問題：LZW算法受專利保護，所以不允許使用這種算法來解壓縮GIF等文件。
u 通過文件名得到圖片實例
通過簡單地改變圖片引用路徑將示例代碼0601改成示例代碼0602：
Image gif = Image.getInstance("vonnegut.gif");
Image jpeg = Image.getInstance("myKids.jpg");
Image png = Image.getInstance("hitchcock.png");
同示例代碼0601的區別只是該圖像從本地獲取而已，另外一個例子見示例代碼0603。
圖片的位置
u 對齊方式
通過下面方法設置圖片的對齊方式：
Alignment = Image.RIGHT
Alignment = Image.MIDDLE
Alignment = Image.LEFT
參見示例代碼0604。
我們將Vonnegut的圖片放在右邊，小孩的圖片放在中間，hitchcock的圖片放在左邊。
u 圖片和文本
另外，你還可以指定文本相對圖片的環繞方式：
Alignment = Image.RIGHT | Image.TEXTWRAP
Alignment = Image.MIDDLE
Alignment = Image.LEFT | Image.UNDERLYING
見示例代碼0506，文字在Vonnegut圖片的左側，並不在我小孩的圖處環繞，且排在Hitchcock圖片的上面。
說明：該功能尚有一些BUG。
u 絕對位置
當製作PDF文件時，你可能用到該方法：
public void setAbsolutePosition(int absoluteX, int absoluteY)
將一個圖片放要頁面上一個絕對位置的代碼見示例代碼0606，我們在不同的坐標處添加了兩幅圖片，這裡使用給定的坐標將圖片放在了左下角，通過將圖片的寬度和高度作為X和Y坐標將設置第一個圖片，坐標的2倍設置第二個圖片。
縮放和旋轉圖片
u 縮放
有幾種辦法可以縮放圖片：
public void scaleAbsolute(int newWidth, int newHeight)
public void scalePercent(int percent)
public void scalePercent(int percentX, int percentY)
public void scaleToFit(int fitWidth, int fitHeight)
小孩的圖片大小為194×202象素，如果你想讓圖片小一些，你可以通過scaleAbsolute(97, 101)進行縮放，使用scalePercent(50)也能到達同樣的效果。
還可以通過scaleAbsolute(194, 101)來減小，所以這些例子都放在了示例代碼0607中。
u 對分辨率的影響
如果一個圖片不經任何縮放，其分辨率（resolution）為72，如果該圖片縮放比例為50％，則分辨率為144，如果有更低的縮放比，則分辨率將更大，因為象素相同但尺寸變得更小了。使用72/300=24％的比例放置一個300dpi的圖片，例：你用300dpi掃瞄了一個5×5英吋的圖片，圖片結果為1500×1500象素（5×300），當你用24％（72/300=0.24）的比例將該圖片放置到PDF文件中時，PDF中的圖片將為5×5英吋1500X1500象素300dpi，該圖片將始終為1500X1500象素而不管尺寸如何。
u 旋轉
可以通過下面的方法旋轉圖片
public void setRotation(double r)
詳見示例代碼0608。
原始圖片數據
到目前為止，所有例子中使用的圖片均來自地本地磁盤或者某個網站，但也可能使用包含圖片信息的數組來得到圖片的實例：
public static Image getInstance(byte[] img)
該方法同前面方法的效果相同，返回一個新的Gif,Jpeg或者Png類別的Image對象。
在示例代碼0609中，我們添加一個從一個Jpeg文件中讀入到字節數組中的圖片，很明顯，使用其他getInstance方法得到實例更優越，但這僅僅是一個例子，該getInstance方法在動態創建那些根本不存在的圖片時非常有用。
該例子也演示了如何創建和使用一個原始圖片。
public static Image getInstance(int width, int height, int components, int bpc, byte data[])
本例中創建了一個100×100象素的圖片，因為每個像素用RGB描述，所以圖片大小為100×100×3字節。
System.Drawing.Bitmap
示例代碼0610是一個比較高級的話題，理由如下：
首次使用到了System.Drawing.Bitmap類。該類在.net框架中，可以使用更多類型的圖片，如TIFF、GIF，而這些圖片在iText中均不支持，你可以檢查一下.net框架看看你需要的圖片格式是否得到支持。
前面的例子中，還有一些事情要注意：當添加一個圖片時不會出現什麼問題，文字始終浮於圖片上面，本例中，我們希望圖片浮在文字上面。這也是為什麼我們將使用iTextSharp.text.pdf.PdfContentByte類的原因（見第十章）。
你將發現使用的圖片為透明的gif格式，你可以到http://itextsharp.sourceforge.net/examples/h.gif下載得到。
TIFF和CCITT
示例代碼0611也是一個比較高級的話題，例中轉換一個TIFF文件到PDF文件。
u 圖片遮罩
示例代碼0613在，我們創建了一個用作遮罩的圖片

 

 

 

3C

 

 

7E

 

 

E7

 

 

C3

 

 

C3

 

 

E7

 

 

7E

 

 

3C

 

 

 

 

 

該圖片尺寸為8×8象素，每組一個字節，使用makeMask()方法可以轉換成遮罩。
byte maskr[] = {(byte)0x3c, (byte)0x7e, (byte)0xe7, (byte)0xc3, (byte)0xc3, (byte)0xe7, (byte)0x7e, (byte)0x3c};
Image mask = Image.getInstance(8, 8, 1, 1, maskr);
mask.makeMask();
mask.setInvertMask(true);
我們可以用該遮罩直接遮住其他圖片的一部分。
PdfContentByte cb = writer.DirectContent;
Image image = Image.getInstance("vonnegut.gif");
image.ImageMask = mask;
或者我們將該遮罩用於模板遮罪中。
PdfContentByte cb = writer.DirectContent;
cb.setRGBColorFill(255, 0, 0);
cb.addImage(mask, mask.scaledWidth() * 8, 0, 0, mask.scaledHeight() * 8, 100, 400);
關於ContentByte對像更多信息請參見第十章。
圖片和其他對像
u 圖片在塊中
有時，可以方便地將圖片置於塊中，通過一定偏移將一個圖片置於塊中：
Chunk ck = new Chunk(img, 0, -5);
具體代碼見示例代碼0614，我們可以添加該特殊圖片塊到短句、表格等，本例中的圖片請到http://itextsharp.sourceforge.net/examples/pngnow.png下載。
u 圖片在表格中
你可以將圖片添加到單元格中，但有兩個副作用：
l 表格的寬度是確定，當圖片超出單元格的寬度時，將自動縮小。
l 你不能進行文字繞排和為圖片添加下劃線。
參見示例代碼0615。
u 圖片鏈接註釋
如果你希望得到一個可點擊的圖片，或者想添加鏈接註釋到圖片上，你需要創建一個Annotation對象，並添加到圖片上，你不需要指定位置（你可以使用0,0,0,0），該位置會內部更新以適合該圖片。
gif.Annotation = new Annotation(0, 0, 0, 0, "Chap1102b.pdf", 3);
jpeg.Annotation = new Annotation("picture", "These are my children", 0, 0, 0, 0);
參加示例代碼0616。
第二部分 其他文檔格式
第七章 XML和 (X)HTML
本章主要介紹了如何利用iText控件生成XLM文檔和（X）HTML文檔，但我們對這些並不感興趣，故只介紹本章中提到的將XML轉為PDF。
在第一章中，我們通過5步生產一個PDF文件，為了將一個XML文件轉換為PDF文件，只需重寫第3和第4步，第5步由解析器自動處理。
//第3步：創建一個解析器並設置文檔句柄：
iTextHandler h = new iTextHandler(document);
//第4步，轉換該文檔：
h.Parse("Chap0701.xml");
示例代碼見示例代碼0702
第八章 RTF文件
RTF包
RTF包是基於iText包擴展出來的，允許iText除生成PDF文件外還可以輸出RTF文件，除了一些在RTF包中不支持的特性外，大多數PDF文件特性都可以使用。
創建一個RTF文檔
創建一個RTF文檔和創建一個PDF文檔方法是一樣的，都是這基本的5步，唯一的區別是第2步中用RtfWriter代替了PdfWriter，見示例代碼0801。
第1步 創建一個the iTextSharp.text.Document對象的實例：
Document document = new Document();
第2步 創建一個document的RtfWriter將document寫入你選擇的輸出流：
RtfWriter.getInstance(document, new FileStream("Chap0801.rtf"), FileMode.Create);
第3步 打開document:
document.Open();
第4步 添加內容到document
document.Add(new Paragraph("Hello World"));
第5步 關閉document
document.Close();
關於如何創建其他對象並添加到document中，請參見其他章節的內容。
不支持的特性
水印
閱讀器參數
加密
內嵌字體
塊間距
段落右縮排
列表右縮排
無圓點符號列表
嵌套表格
除JPEG和PNG的其他圖片
RTF中擴展的頁眉和頁腳
寫入RTF時無法在開始新頁前通過setHeader方法改變文檔的頁眉或頁腳，這裡有兩個辦法來解決這個問題。
利用「Chapters」，添加一個新「chapter」到文檔前，使用setHeader或setFooter，你可以在不同的「Chapters」中使用不同的頁眉或頁腳，見示例代碼0802。
使用RtfHeaderFooters類。該類允許你設置4個頁眉或頁腳，並指定在哪頁出現。你當然可以結合Chapter創建4個不同的頁眉或頁腳，見示例代碼0803。
u 使用RtfHeaderFooters類
第1步創建一個RtfHeaderFooters類：
RtfHeaderFooters headers = new RtfHeaderFooters();
第2步添加HeaderFooter對像
headers.Add(RtfHeaderFooters.LEFT_PAGES, new HeaderFooter(new Phrase("This header is only on left hand pages")));
headers.Add(RtfHeaderFooters.RIGHT_PAGES, new HeaderFooter(new Phrase("This header is only on right hand pages")));
第3步如同使用頁眉頁腳一樣使用RtfHeaderFooters
document.Header = headers;
使用RtfHeaderFooters.add(...)的常量：
FIRST_PAGE: 在你文檔的第一頁使用該頁眉或頁腳。你將使用rtfWriter.HasTitlePage = true來完成
LEFT_PAGES: 所有左邊頁均使用該頁眉或頁腳
RIGHT_PAGES: 所有右邊頁均使用該頁眉或頁腳
ALL_PAGES: 所有頁均使用該頁眉或頁腳，只有和FIRST_PAGE 結合使用才有意義。
有一件事非常重要：如果你使用LEFT_PAGES或者RIGHT_PAGES來設置頁眉或頁腳，再使用ALL_PAGES，頁眉和頁腳均不會起作用。
表格效果見示例代碼0804。
第三部分 iText的高級應用
第九章 字體
本章原文講了許多字體的使用技巧，但就是沒有講如何使用中文，因此，意義不大，再說，如果不支持中文，前面的也就白翻譯了，因此，根據原文講到的一些知識，我摸索出漢字的使用方法，自己寫了本章內容，應該算是「原創」了吧^_^(哎呀！誰拿雞蛋扔我……)。
Windows中一般都是使用TrueType字體，每個中文版Windows操作系統均默認安裝了細明體、仿宋、黑體和楷體四種字體，你還可以安裝其他第三方字體，如安裝了Office 2000後，會自動安裝華文行楷等字體，比較奇怪的是，在PDF文件中插入了一種本計算機才有的字體，在打開PDF文件的計算機上雖然沒有該字體，但仍然能正常顯示！這有別於Word文件，Word文件將當前計算機中沒有的字體一律用細明體代替，這大概是意外收穫吧。
字體文件一般保存在windir\Fonts目錄中，擴展名為TTF，還有擴展名為TTC的字體文件，也是TrueType字體，不過是一個集合，也就是裡面有多種字體。下面列出windows2000簡體中文版四種標準字體的文件名稱：
SIMSUN.TTC：細明體和新細明體
SIMKAI.TTF：楷體
SIMHEI.TTF：黑體
SIMFANG.TTF：仿細明體
TrueType字體應用
按下面的方法寫入黑體字文字，大小為32磅：
BaseFont bfHei = BaseFont.createFont(@"c:\winnt\fonts\SIMHEI.TTF", BaseFont.IDENTITY_H, BaseFont.NOT_EMBEDDED);
Font font = new Font(bfHei, 32);
String text = "這是黑體字測試！";
document.Add(new Paragraph(text, font));
不要管BaseFont.createFont方法第二、三個參數的意思，依葫蘆畫瓢就行了，第一個參數顯示就是字體文件存放的位置。
後面的代碼都非常好理解，不再贅述。
TruType字體集合的應用
字體集合的使用同上面差不多，只是在在createFont方中要指定使用哪種字體。如：
BaseFont bfSun=BaseFont.createFont(@"c:\winnt\fonts\SIMSUN.TTC,1", BaseFont.IDENTITY_H, BaseFont.NOT_EMBEDDED);
font = new Font(bfSun, 16);
text = "這是字體集合中的新細明體測試！";
document.Add(new Paragraph(text, font));
不難看出，在使用BaseFont.createFont方法時，第一個參數@"c:\winnt\fonts\SIMSUN.TTC,1"中多了一個「,1」，表示使用序號為1字體，序號為0的字體為細明體。
畢竟我們不是做排版軟件，有了上面的辦法就基本上夠用了，真正很複雜的PDF文件製作，不妨做成XML文件（最簡單的辦法就是用Word排版，然後另存為web頁了），然後按第七章的辦法轉換。
代碼見示例代碼0901。
第十章 圖像和文本的絕對位置
pdfContentByte
到目前為止，我們已經使用了簡單的iText，我們已經添加了文本、圖片、段落、章節、列表、表格等，沒有涉及到佈局問題。Itext分割文本到每頁中，並將每個單詞、句子、段落佈置到頁面上，但有時我們並不需要這種自動格式，有時我們希望將一些圖像或者文本放置在某頁的指定位置，為實現該功能，我們將使用PdfContentByte類。
為代替第一章，僅用PdfWriter類的getInstance方法是不夠的，你必須真實地擁有一個PdfWriter對象，你可以通過在使用Writer對像中使用getDirectContent()方來得到該對象。例：
PdfWriter writer = PdfWriter.getInstance(document, new FileOutputStream("test.pdf"));
PdfContentByte cb = writer.DirectContent;
說明：當你添加高級對像（如表格）時，兩個PdfContentByte對像將被內部使用：一個用於文本，一個用用於圖像（如邊界或單元格背景）。文本繪製浮於圖像的上面。
當你通過getDirectContent()方法直接使用PdfContentByte對像時，你所添加的所有對象都將浮於文本和圖像。如果你想避免這種情況和希望添加內容在圖像或文本的背後，你需要使用用getDirectContentUnder()方。
一句話，當一頁完成時，4層的重疊遵照如下順序：
1、 通過getDirectContentUnder()得到的PdfContentByte
2、 包含圖像或高級對象的內部PdfContentByte
3、 病文本或高級對象的內部PdfContentByte
4、 通過getDirectContent()得到的PdfContentByte
簡單圖形
在示例代碼1001中，繪製了一些簡單圖形，我們使用了諸如moveTo和lineTo方法來在移動到頁面上當前位置然後畫一條直線到其他位置。我們使用了諸如setLineWidth和setLineDash方法來改變直線的外觀，如：
cb.LineWidth = 10f;
cb.moveTo(100, 700);
cb.lineTo(200, 800);
cb.stroke();
說明：當你改變諸如顏色、線寬等屬性時，只有你在調用stroke方法時才起作用。在例中繪製三角形時，我們設置顏色為綠色，在使用stroke方法前我們改變顏色為紅色，則繪製三角形的結果為為紅色而不是綠色，該例中還有矩形、圓等使用方法。
文本
當你想將文本寫入ContentByte中時，你必須使用方法beginText()和endText，你也必須設置字體和尺寸。就像圖形示例中一樣，還有許多方法用於寫入和放置文本，但你最需要的是方法showTextAligned和方法showText配合setTextMatrix。
例1：
BaseFont bf = BaseFont.createFont(BaseFont.HELVETICA, BaseFont.CP1252, BaseFont.NOT_EMBEDDED); cb.beginText();
cb.setFontAndSize(bf, 12);
cb.showTextAligned(PdfContentByte.ALIGN_CENTER, text + "This text is centered", 250, 700, 0);
cb.endText();
例2：
BaseFont bf = BaseFont.createFont(BaseFont.HELVETICA, BaseFont.CP1252, BaseFont.NOT_EMBEDDED);
cb.beginText();
cb.setFontAndSize(bf, 12);
cb.setTextMatrix(100, 400);
cb.showText("Text at position 100,400.");
cb.endText();
請參見示例代碼1002。
模板（Form xObjects）
當我們在第四章討論頁眉和頁腳時，我們定義了一小塊添加到每一頁的信息，實際上，該小塊信息寫到了文件的每一個新頁上。這並不是最經濟的解決方案，更好的辦法是將該信息作為一個Form Xobject僅在文檔中添加一次，在其可見位置重複出現。我達到該目的，我們將使用模板。
u 創建一個PdfTemplate
u 創建PdfTemplate的最好方法是調用PdfContentByte對像中的createTemplate方法：
PdfContentByte-object:
PdfTemplate template = cb.createTemplate(500, 200);
這樣，該模板的寬度為500，高度為200。
通過該模板我們可以做象PdfContentByte同樣的事情
template.moveTo(0, 200);
template.lineTo(500, 0);
template.stroke();
template.beginText();
BaseFont bf = BaseFont.createFont(BaseFont.HELVETICA, BaseFont.CP1252, BaseFont.NOT_EMBEDDED);
template.setFontAndSize(bf, 12);
template.setTextMatrix(100, 100);
template.showText("Text at the position 100,100 (relative to the template!)");
template.endText();
u 添加一個模板到文檔
通過象下面一樣在絕對位置添加一個模板：
cb.addTemplate(template, 0, 400);
你還可以做一些有趣的事情，如縮放或旋轉他們：
//將模板旋轉90度
cb.addTemplate(template, 0, 1, -1, 0, 500, 200);
// 縮放模板為50％
cb.addTemplate(template, .5f, 0, 0, .5f, 100, 400);
//縮放模板為200％
cb.addTemplate(template, 2, 0, 0, 2, -200, 400);
具體演示見示例代碼1003。
u 第幾頁共幾頁
在一些情況下，你希望插入一些你在寫本頁時外殼無法知道的信息到文本中去，如：在一篇文檔的第一頁，你並不知道該文檔共有幾頁。只能在完成了整個文檔時才知道總的頁數。當使用模板時，該問題就不存在了。在示例代碼0103中，我們在添加模板到ContentByte前添加了一些信息到模板中，這是沒有必要的。我們可以在任何時候添加信息到模板，因為iText添加Form Xobject是在PDF結束的地方（當通過close方法關閉該文檔時調用）。示例代碼1004顯示了首先創建4頁然後添加總到頁數，該例非常簡單和有用。
分欄
在本章以前，你已經掌握了如何將文本放在一個絕對位置，這種情況下，我們要確定文本的開始坐標。如果我們想知道文本的結束位置，我們得做一些計算工作。
現在我們要加一些文本到一個矩形框的內部，希望文本到達右邊界時自動換行。超出矩形部分將不顯示，可以通過ColumnText類實現。
舉個例子：
為顯示一個指定的短句在坐標(100, 300)和(200, 500)間的矩形內居中，我們使用下面的代碼：
PdfContentByte cb = writer.DirectContent;
ColumnText ct = new ColumnText(cb);
ct.setSimpleColumn(phrase, 60, 300, 100, 500, 15, Element.ALIGN_CENTER);
ct.go();
通過查看示例代碼1005，你會立即發現通過該方法可以可以畫一些複雜的表格而無須Table對象。
另一個例子：
沒有必要一次性將文本全部添加進去，你可以先定義一個矩形，然後添加一些文本，最後用go方法顯示分欄。
PdfContentByte cb = writer.DirectContent;
ColumnText ct = new ColumnText(cb);
ct.setSim7pleColumn(60, 300, 100, 500, 15, Element.ALIGN_CENTER);
ct.addText(phrase1);
ct.addText(phrase2);
ct.addText(phrase3);
ct.go();
詳見示例代碼1006。
多欄
當然，如果文本超出了矩形範圍，我們並不想丟失這些多出的文本，或許我們想將這些文本顯示到其他欄中。這就是為什麼我們要查看go方法返回值的原因。如果返回標識為「NO_MORE_COLUMN」，表示該欄中沒有足夠的空間存放該文本，如果所有的文本均顯示出來，標識將為「NO_MORE_TEXT」。
請參見示例代碼1007。
不規則欄
定義一個非矩形的區域來顯示欄也是可能的,通過使用setColumns方法,我們為文本定義了一個左右邊界。
float[] left = {70,790, 70,60};
float[] right = {300,790, 300,700, 240,700, 240,590, 300,590, 300,106, 270,60};
ct.setColumns(left, right);
左邊界是一條直線，而右邊界是不規則的。該函數的結果可以導致一些非常有意思的佈局，見示例代碼1008，本例中你將用到一個名為caesar_coin.jpg的圖片：

PdfTable
在第5章中，我們簡要地講述了PdfPTable對象，現在我們將討論該對像更多的的特性。
你可以用3種不同的方法創建PdfTable：
PdfPTable(float[] relativeWidths);
PdfPTable(int numColumns);
PdfPTable(PdfPTable table);
你可以給該表設置更多的參數，如表寬度、列寬度、水平對齊方式等，你可以通過下面的辦法添加單元格：
public void addCell(PdfPCell cell);
public void addCell(PdfPTable table);
public void addCell(Phrase phrase);
public void addCell(String text);
除了單元格填距和和間距，這些方法同Table對像非常類似。這些參數對每個單元格個體進行了設置，當然，你可以設置單元格的默認值，為改變單元格的默認值，使用getDefaultCell()和調用一個或更多的類PdfPCell的方法（你可以設置對齊方式、間距、邊框、顏色甚至最低高度）。
註：通過PdfPTable，你能改變一個單元格的列跨度，但不能改變行跨度！在PdfPTable內部是一些獨立的行，要讓它支持行跨度更改需要對PdfPTable對像進行很大的調整，不要期望在近期內實現，你可以用嵌套表來解決這些問題。
你可以像第5章一樣將一個PdfPTable添加到當前文檔中，但你也可以添加一個表在當前頁中的絕對位置：
public float writeSelectedRows(int rowStart, int rowEnd, float xPos, float yPos, PdfContentByte canvas);
參數rowStart是你想開始的行的數目，參數rowEnd是你想顯示的最後的行（如果你想顯示所有的行，用-1），xPos和yPos是表格的坐標，canvas是一個PdfContentByte對象。在示例代碼1009中，我們添加了一個表在(100,600)處：
table.writeSelectedRows(0, -1, 100, 600, writer.DirectContent);
使用PdfPTable，你不能設置行跨度和（或）來跨度（怎麼和上面的有點矛盾？）你可以使用嵌套表來解決，見示例代碼1010。
最後，示例代碼1011和示例代碼1012展示了PdfTable可以和templates 和 columns一起使用，在示例代碼1012中將用到cover.png圖片如下：

顏色（SpotColors）和圖案(Patterns)
顏色（spotcolors）的使用見示例代碼1013，示例代碼1014和示例代碼1015演示了圖案(patterns)的使用方法。
第十一章 本地和異地轉向、目標和概要
本地轉向
有時你需要一個允許讀者從文檔的一個地方跳轉到另外一個地方的鏈接，你可以通過類Chunk的setLocalGoto 和setLocalDestination兩個方法實現，例：
Chunk localgoto = new Chunk("this word", FontFactory.getFont(FontFactory.HELVETICA, 12, Font.NORMAL, new Color(0, 0, 255))).setLocalGoto("test");
Chunk destination = new Chunk("local destination", FontFactory.getFont(FontFactory.HELVETICA, 12, Font.NORMAL, new Color(0, 255, 0))).setLocalDestination("test");
見示例代碼1101。
異地轉向
在第3章中，我們演示了一個錨點如何轉向到其他URL，一個錨點通過不同的字體、風格和顏色，可以包含不同的Chunks，在iText的高級應用中，下面定義鏈接到URL的其他方法：
Chunk chunk = new Chunk("anchor", FontFactory.getFont(FontFactory.HELVETICA, 12)).setAnchor(new URL("http://www.lowagie.com/iText/"));
u 轉到PDF文檔中的指定位置
如果你在文檔中指定了一個目的地，你可以從另外一個文檔跳轉到這裡，為實現該功能，你可以使用方法：
setRemoteGoto: Chunk chunk = new Chunk("jump", FontFactory.getFont(FontFactory.HELVETICA, 12, Font.ITALIC)).setRemoteGoto("test.pdf", "test"));
test.pdf是另外一個pdf文件，」test」是該文件的一個目的地。
跳轉到另一個PDF文件指定頁
使用方法setRemoteGoto，用頁碼參數代替名稱參數，可以非常容易地跳轉定另外一個文檔的指定頁：
chunk = new Chunk("jump", FontFactory.getFont(FontFactory.HELVETICA, 12, Font.ITALIC)).setRemoteGoto("test.pdf", 3));
見示例代碼1102
u 啟動一個應用程序
可以使用下面的方法啟動一個應用程序：
public PdfAction(String application, String parameters, String operation, String defaultDir)
如果application為「c:/winnt/notepad.exe」（其餘參數可以為null），你可以通過PDF文件中的鏈接來啟動記事本程序。
u 文件和URL
如果你想跳轉到其他文檔或URL，你需要通過下面的構造函數之一創建一個：
PdfAction(String filename, String name);
PdfAction(String filename, int page);
PdfAction(URL url);
PdfAction(String url);
前面兩個構造函數允許你跳轉到文件的指定位置或頁碼，後兩個構造函數允許你跳轉到其他URL上。
其餘部分略。
第十二章 頁面和表格事件
略。