iTextSharp快速使用指南

標籤：style   blog   http   color   使用   os   

原文:iTextSharp快速使用指南

前言

最近公司一直使用iText開發PDF報表，使用一段時間之後發現iText這個類庫雖然是龐大無比，但作為程式猿我們不需要知道所有的類和方法，我們只需要知道如何使用即可。

所以這篇文章就是告訴大家如何快速的使用iTextSharp(iText .net版本）進行開發。

iTextSharp開發步驟

快速開發之前，我們先瞭解以下4個類：

class	所代表的含義
Paragraph	報表中的文本
Image	報表中的圖片
PdfPTable	表格
PdfPCell	儲存格

知道這4個類之後就是開發的步驟了：

1. 往儲存格PdfPCell類中新增內容。

2.將儲存格PdfPCell添加到PdfPTable。

3.將表格PdfPTable添加到Document。

在以上的步驟中最重要的就是第一步也就是往PdfPCell中新增內容，而PdfPCell中的內容又可以分為以下三種情況：

文本	Paragraph
圖片	Image
表格	PdfPTable

接下來我們就直奔主題，看是如何往PdfPCell新增內容。因為報表需要資料，所以我就從百度解析度統計擷取了一些資料，下面是這個網址的：

往PdfPCell添加文本

文本由Paragraph來表示，在添加之前還要注意一下字型的問題，因為我們用的是中文字型，如果用預設英文字型渲染則會亂碼，所以我們要先定義中文字型：

BaseFont BF_Light = BaseFont.CreateFont(@"C:\Windows\Fonts\simsun.ttc,0", BaseFont.IDENTITY_H, BaseFont.EMBEDDED);

字型定義完之後下面就添加文本：

//要設定字型和大小p = new Paragraph(fields[i], new Font(BF_Light, 13));cell = new PdfPCell(p);//設定cell屬性//cell.Border = Rectangle.NO_BORDER;if (rowNum == 0){    cell.BackgroundColor = BaseColor.GRAY;}if (i == mainColumn - 1){    cell.HorizontalAlignment = Element.ALIGN_RIGHT;}//添加儲存格table.AddCell(cell);

其實添加很簡單，就是最上面兩行代碼，而對PdfPCell屬性設定的代碼一般會比較多，因為我們一般要設定其背景色，水平對其，還有邊框Border等。

往PdfPCell添加圖片和表格

在大家瞭解怎麼往PdfPCell添加完文本之後，添加圖片和表格就簡單很多了，就是將Image和PdfPTable作為PdfPCell的構造器參數傳入即可：

//圖片Image image = Image.GetInstance(imagePath);cell = new PdfPCell(image, true);table.AddCell(cell);//表格PdfPTable baseTable = GetBaseTable();cell = new PdfPCell(baseTable);table.AddCell(cell);

以下就是：

iTextSharp畫圖

通過以上PdfPCell的操作，大家就可以實現一些比較常見的PDF報表，現在我們更進一步實現一下的效果：

這裡就必須用到畫圖，畫圖用的就是PdfContentByte類，這個就類似於畫板，我們可以直接在上面畫直線和文本：

//畫線canvas.SaveState();canvas.SetLineWidth(2f);canvas.MoveTo(100, 100);canvas.LineTo(200, 200);canvas.Stroke();canvas.RestoreState();//文本ColumnText.ShowTextAligned(canvas, Element.ALIGN_RIGHT, new Phrase("JulyLuo測試", new Font(BF_Light, 10)), 100, 20, 0);

這裡要注意的是，無論是畫線還是文本我們都需要座標，而且在畫線的時候，要將具體的代碼放在SaveState和RestoreState中間，這樣就不會導致畫圖狀態的紊亂。

如果我們希望將畫在一個儲存格中，但我們知道畫圖需要座標，而在PdfPCell中是座標沒有暴露出來，所以這裡我們需要iTextSharp中的介面：IPdfPCellEvent

public void CellLayout(PdfPCell cell, Rectangle position, PdfContentByte[] canvases)

這個介面的意思就是在儲存格添加到文檔之後暴露的方法。很明顯，通過postion參數我們可以擷取座標，canvases參數可以擷取畫板。

所以要畫圖就建立一個實現介面IPdfPCellEvent的類，然後在CellLayout方法中畫線和文本：

public void CellLayout(PdfPCell cell, Rectangle position, PdfContentByte[] canvases){    PdfContentByte cb = canvases[PdfPTable.BACKGROUNDCANVAS];    PdfContentByte cbline = canvases[PdfPTable.LINECANVAS];    cbline.SaveState();    cb.SaveState();    …………    cb.SetLineWidth(0.4f);    cbline.SetLineWidth(0.4f);    //y 軸    cb.MoveTo(leftX, bottomY);    cb.LineTo(leftX, topY);    cb.Stroke();    //y 軸突出的虛線    float yAxiseTextLinetWidth = 3f;    float yAxisTextSpaceAdjust = 2.5f;    for (float y = yScaleNum; y < yMax; y += yScaleNum)    {        float yPoint = bottomY + (yScale * y);        cb.MoveTo(leftX, yPoint);        cb.LineTo(leftX - yAxiseTextLinetWidth, yPoint);        cb.Stroke();    }    //y 軸文本    for (float y = yScaleNum; y < yMax; y += yScaleNum)    {            float yPoint = bottomY + (yScale * y);            ColumnText.ShowTextAligned(cb, Element.ALIGN_RIGHT, new Phrase(string.Format("{0}%", y), new Font(BF_Light, 5)), leftX - yAxiseTextLinetWidth, yPoint - yAxisTextSpaceAdjust, 0);    }                    //x 軸    cb.MoveTo(leftX, bottomY);    cb.LineTo(righX, bottomY);    cb.Stroke();    ………    cb.Stroke();    cb.RestoreState();    cbline.RestoreState();}

最後將這個類和對應的PdfPCell關聯起來：

//畫圖的類，和cell關聯                        ResolutionChart chart = new ResolutionChart(fileName, yMax, yScale);cell.CellEvent = chart;

以下就是：

總結用iTextSharp進行開發，如果報表只有文本，圖片則PdfPCell一個類就可以搞定。但如果要畫一些bar chart,bar chart，這些圖是需要座標來呈現，我們可以通過IPdfPCellEvent介面擷取座標，然後畫相應的圖，最後就是代碼下載了。