一步一步ITextSharp 低级操作函数使用

最新推荐文章于 2025-06-09 13:31:44 发布
转载 最新推荐文章于 2025-06-09 13:31:44 发布 · 1.3k 阅读 · 1

本文深入解析PDF文档的高级操作，包括文本对齐、缩放、倾斜和填充模式，以及如何利用ColumnText对象实现分栏布局。通过实例代码展示各项功能的应用，帮助读者掌握PDF文档编辑技巧。

摘要生成于 C知道 ，由 DeepSeek-R1 满血版支持， 前往体验 >

首先说一下PDF文档的结构：

image

分为四层，第一层和第四层由低级操作来进行操作，第二层、第三层由高级对象操作

第一层操作只能使用PdfWriter.DirectContent操作，第四层使用DirectContentUnder操作。

第二层和第三层的PdfContentByte是由IText内部操作，没有提供api接口。

图形和文本状态解释

图形状态，就是作图时对图形一些环境设置，

使用低级操作输出文本或图形前，应该设置操作环境，并且操作完成后，应该恢复操作前的环境。

使用低级操作是非常复杂的一般情况不需要使用这种方式，下面对常用用个法进行说明：

1、PdfContentByte.ShowTextAligned()

方法签名如下：

   1: public void ShowTextAligned(int alignment, String text, float x, 
   2: float y, float rotation)
   3: public void ShowTextAlignedKerned(int alignment, String text,
   4:  float x, float y, float rotation)

参数说明：

alignment:左、右、居中(ALIGN_CENTER, ALIGN_RIGHT or ALIGN_LEFT)

text：要输出的文本

x:文本输入的X坐标

y:文本输入的Y坐标

rotation:文本的旋转角度

实例：

image

代码：

   1: public class TextRotaiDemo : TestBase
   2:     {
   3:         protected override void WriteDocument(Document document, PdfWriter writer)
   4:         {
   5:             var direct = writer.DirectContent;
   6:             direct.SaveState();//保存当前的输出状态
   7:             String foobar = "ShowTextAligned演示";
   8:  
   9:             direct.BeginText();
  10:             direct.SetFontAndSize(Normal.BaseFont, 12);
  11:             direct.ShowTextAligned(Element.ALIGN_LEFT, foobar, 400, 788, 0);
  12:             direct.ShowTextAligned(Element.ALIGN_RIGHT, foobar, 400, 752, 0);
  13:             direct.ShowTextAligned(Element.ALIGN_CENTER, foobar, 400, 716, 0);
  14:             direct.ShowTextAligned(Element.ALIGN_CENTER, foobar, 400, 680, 30);
  15:             direct.ShowTextAligned(Element.ALIGN_LEFT, foobar, 400, 644, 0);
  16:             direct.EndText();
  17:             direct.RestoreState();//恢复输出状态
  18:         }
  19:     }

第一行文字： x = 400;y = 788.
第二行文字： x = 400; y = 752.
第三行文字： x = 400, y = 716.
第四行文字： x = 400, y = 680, 并旋转30度.
第五行文字： 使用showTextAlignedKerned() 方法显示相同的字符串, 但它使用了字形字距调整.

可以通过对位置的控制，在不同的位置显示出不同文字，并且也可以调用图形函数进行作图，如果创建矩形、圆、线条，表格等不规则图形。

2、对于文本的输出“ColumnText”对象的方法“ShowTextAligned”也是可用，并且使用起来比前面那个更方便，方法签名如下：

   1: public static void ShowTextAligned(PdfContentByte canvas, int alignment, 
   2: Phrase phrase, float x, float y, float rotation)
   3: public static void ShowTextAligned(PdfContentByte canvas, int alignment, 
   4: Phrase phrase, float x, float y, float rotation, int runDirection, int arabicOptions)

canvas:层对象

alignment:对齐方式

phrase:待写入对象

x:坐标x

y:坐标y

rotation:旋转角度

runDirection:这个是运行方向，从源代码中，说这个没有起什么作用

arabicOptions:这个参数具体功能不太清

在使用上只使用第一个版本就可以了

演示实例如下：

使用第一个重载                                使用第二个重载

imageimage

从效果来看，两个生成的结果基本一致。

代码如下：

   1: public class ColumnTextShowTextAlignedDemo : TestBase
   2:     {
   3:         protected override void WriteDocument(Document document, PdfWriter writer)
   4:         {
   5:             var foobar = new Phrase("Show Text Aligned 演示",Normal);
   6:  
   7:             var direct = writer.DirectContent;
   8:             ColumnText.ShowTextAligned(direct,Element.ALIGN_LEFT, foobar, 400, 788, 0);
   9:             ColumnText.ShowTextAligned(direct, Element.ALIGN_RIGHT, foobar, 400, 752, 0);
  10:             ColumnText.ShowTextAligned(direct, Element.ALIGN_CENTER, foobar, 400, 716, 0);
  11:             ColumnText.ShowTextAligned(direct, Element.ALIGN_CENTER, foobar, 400, 680, 30);
  12:             ColumnText.ShowTextAligned(direct, Element.ALIGN_LEFT, foobar, 400, 644, 0);
  13:  
  14:  
  15:             ColumnText.ShowTextAligned(direct, Element.ALIGN_LEFT, foobar, 400, 488, 0, PdfWriter.RUN_DIRECTION_NO_BIDI, 0);
  16:             ColumnText.ShowTextAligned(direct, Element.ALIGN_RIGHT, foobar, 400, 452, 0, PdfWriter.RUN_DIRECTION_NO_BIDI, 0);
  17:             ColumnText.ShowTextAligned(direct, Element.ALIGN_CENTER, foobar, 400, 416, 0, PdfWriter.RUN_DIRECTION_LTR, 0);
  18:             ColumnText.ShowTextAligned(direct, Element.ALIGN_CENTER, foobar, 400, 380, 30, PdfWriter.RUN_DIRECTION_DEFAULT, 0);
  19:             ColumnText.ShowTextAligned(direct, Element.ALIGN_LEFT, foobar, 400, 344, 0, PdfWriter.RUN_DIRECTION_NO_BIDI, 1);
  20:         }
  21:     }

3、chunk的缩放和倾斜、填充模式：

水平缩放：

public Chunk SetHorizontalScaling(float scale)

设置一个浮点数，1表示正常，小于1缩小

倾     斜：

public Chunk SetSkew(float alpha, float beta)

这个是模拟italic效果的一种方式，带有两个参数，表示两个角度

填充模式：

SetTextRenderMode：

■PdfContentByte.TEXT_RENDER_MODE_FILL—这是一种默认模式，填充整个对象，而不是笔画填充（the glyph shapes are filled, not stroked.

clip_image001

）

■ PdfContentByte.TEXT_RENDER_MODE_STROKE—这种模式使用笔画填充

clip_image002

■ PdfContentByte.TEXT_RENDER_MODE_FILL_STROKE—

clip_image003

■ PdfContentByte.TEXT_RENDER_MODE_INVISIBLE—文本不可见

效果如下：

X[D][2WMJW)M[9IOXH5~29D

代码如下：

   1: public class ChunkScalSekewDemo : TestBase
   2:     {
   3:         protected override void WriteDocument(Document document, PdfWriter writer)
   4:         {
   5:             var foobar = "Show Text Aligned 演示";
   6:             var direct = writer.DirectContent;
   7:             var c = new Chunk(foobar, Normal);
   8:             c.SetHorizontalScaling(0.5f);
   9:             var phrase = new Phrase(c);
  10:             ColumnText.ShowTextAligned(direct,Element.ALIGN_LEFT, phrase, 400, 572, 0);
  11:             c = new Chunk(foobar, Normal);
  12:             c.SetSkew(15, 15);
  13:             phrase = new Phrase(c);
  14:             ColumnText.ShowTextAligned(direct,Element.ALIGN_LEFT, phrase, 400, 536, 0);
  15:             c = new Chunk(foobar, Normal);
  16:             c.SetSkew(0, 25);
  17:             phrase = new Phrase(c);
  18:             ColumnText.ShowTextAligned(direct,Element.ALIGN_LEFT, phrase, 400, 500, 0);
  19:             c = new Chunk(foobar, Normal);
  20:             c.SetTextRenderMode(
  21:               PdfContentByte.TEXT_RENDER_MODE_STROKE,0.1f, BaseColor.RED);
  22:             phrase = new Phrase(c);
  23:             ColumnText.ShowTextAligned(direct,Element.ALIGN_LEFT, phrase, 400, 464, 0);
  24:             c = new Chunk(foobar, Normal);
  25:             c.SetTextRenderMode(PdfContentByte.TEXT_RENDER_MODE_FILL_STROKE, 1, null);
  26:             phrase = new Phrase(c);
  27:             ColumnText.ShowTextAligned(direct,
  28:               Element.ALIGN_LEFT, phrase, 400, 428, -0);
  29:         }
  30:     }

4、ColumnText对象使用

分栏布局也是一种比较常见的方式，如果一段文字的段落比较多，但每段的文字比较少，如果采用分栏的方式可以节约很空间，同样，在显示表格时，如果表格的列比较少，也会节约很多空间。在iText中也是支持分栏布局的，使用的ColumnText对象。

首先说一下，ColumnText对象常用方法：

1、SetSimpleColumn

   1: public void SetSimpleColumn(float llx, float lly, float urx, float ury)
   2: public void SetSimpleColumn(float llx, float lly, float urx, float ury, 
   3: float leading, int alignment)
   4: public void SetSimpleColumn(Phrase phrase, float llx, float lly, 
   5: float urx, float ury, float leading, int alignment)

这个函数的功能就是设置列文本的矩形区域，第二个重载还可以进行设置对齐方式和间距，第三个调用AddText方法加入对象后，再直接调用第二个重载。

2、AddText

   1: public void AddText(Chunk chunk)
   2: public void AddText(Phrase phrase)

这两个方法在文本模式下有效，功能就是加入显示的文字内容，如果在复合模式下，调用这两个函数不起任何作用。

3、AddElement

   1: public void AddElement(IElement element)

复合模式下，使用此方法进行内容添加

4、HasMoreText

检查当前一列显示完成后，是否还有内容存在，如果有就要换下一列，或换页。

5、Go

   1: public int Go()
   2: public int Go(bool simulate)

第一个相当于传入false调用第二重载

simulate表示是否模拟写入

返回值表示，还有没有没有写入的内容

当为false时，就是直接写到文档对象中

重要属性：

Alignment：对齐方式

ExtraParagraphSpace

Leading：间距

Indent：缩进

RightIndent：右缩进

SpaceCharRatio：在使用“justified”时使用

image

itextsharp
07-14
ITextSharp中文教程用C#制作PDF文件全攻略ITextSharp中文教程用C#制作PDF文件全攻略
C#使用iTextSharp封装的PDF文件操作类实例
09-03
标题“C#使用iTextSharp封装的PDF文件操作类实例”指出了本文所要介绍的核心内容，即在C#环境下，使用iTextSharp库对PDF文件进行封装，并创建了操作类的实例。iTextSharp是一个用于创建和操作PDF文件的.NET库，它是...
itextsharp.dll(4.0.8.0)完整示例
wangchunlin880210的专栏
10-24 1958
private void button1_Click(object sender, EventArgs e)        {            //Document:（文档）生成pdf必备的一个对象,生成一个Document示例            Document document = new Document(PageSize.A4, 30, 30, 5, 5);           
iTextSharp DLL使用中文文档指南
最新发布
weixin_33670640的博客
06-09 817
在当今数字化时代，PDF文档因其跨平台性、不可篡改性及固定布局的特点，在企业与个人文档处理中占据重要地位。在.NET环境下处理PDF文档，开发者不仅能够实现创建、编辑、读取、安全保护等功能，还可以进一步自动化文档处理流程，极大提高工作效率。.NET框架为开发者提供了丰富的类库和工具，其中iTextSharp是处理PDF文档最常用的第三方库之一。它提供了一系列API来辅助开发者生成、修改、合并、拆分以及加密PDF文件。
iTextSharp 使用详解
ljl_xyf的专栏
01-12 2937
发布日期：2006-4-11 14:46:26 作者： 出处：http://www.manbu.netPDF文件是目前比较流行的电子文档格式，在办公自动化（OA）等软件的开发中，经常要用到该格式，但介绍如何制作PDF格式文件的资料非常少，在网上搜来搜去，都转贴的是同一段“暴力”破解的方法，代码片断如下： StreamWriter pPDF=new StreamWrite
PDF之itextsharp的使用开发历程2
hjacto的博客
08-07 1346
C# .Net winform,快速实现强大的PDF自动化办公需求，批量快速产生定制的PDF文档，同时支持文档二次处理，itextsharp 类库，强大的开源PDF操作类库
iTextSharp使用手册.pdf
05-21
iTextSharp使用手册pdf中文版 第一章 创建一个 Document 利用 iText 五步创建一个 PDF文件： helloword 。 第一步，创建一个 iTextSharp.text.Document 对象的实例： Document document = new Document(); 第二步，...
itextsharp使用详解.zip
08-17
本讲解将深入探讨iTextSharp的使用，包括如何创建、编辑和打印PDF文档。 一、iTextSharp简介 iTextSharp源自Java的iText库，为.NET开发者提供了全面的PDF处理功能。这个库支持创建全新的PDF文档，修改现有文档，...
C# ITextSharp使用手册
03-02
本手册将详细讲解如何利用ITextSharp进行PDF操作，包括其核心属性、方法以及示例代码，以帮助你熟练掌握这一工具。 1. **ITextSharp简介** ITextSharp是一个开源的.NET库，基于iText Java库，用于处理PDF文档。它...
开源免费且稳定实用的.NET PDF打印组件itextSharp（.NET组件介绍之八）
dfkqtok82472315的博客
12-14 551
在这个.NET组件的介绍系列中，受到了很多园友的支持，一些园友（如：数据之巅、[秦时明月]等等这些大神 ）也给我提出了对应的建议，我正在努力去改正，有不足之处还望大家多多包涵。在传播一些简单的知识的同时，我自己也得到了一些提升，这个是我感觉到的最大的益处。知识需要传播，在传播的过程中去让学习的人去提升，在交流中的过程中去让思考的人去展望，我希望我也能在这个传播的过程中出一份力...
iTextSharp
12-09
iTextSharp,其实很多时候都是用于生成PDF,但是他读取PDF的能力也不差，使用如下： 　　1、下载iTextSharp 　　2、引用动态链接库 　　解压缩下载的压缩包里面的itextsharp-dll-core.zip,得到itextsharp.dll,在项目中添加引用itextsharp.dll即可 　　在文件中需要引入以下3个命名空间： 　　using iTextSharp; 　　using iTextSharp.text; 　　using iTextSharp.text.pdf; 　　3、API的使用方法看代码： 　　[csharp] 　　private string OnCreated（string filepath） 　　{ 　　try 　　{ 　　string pdffilename = filepath; 　　PdfReader pdfReader = new PdfReader（pdffilename）； 　　int numberOfPages = pdfReader.NumberOfPages; 　　string text = string.Empty; 　　for （int i = 1; i <= numberOfPages; ++i） 　　{ 　　byte[] bufferOfPageContent = pdfReader.GetPageContent（i）； 　　text += System.Text.Encoding.UTF8.GetString（bufferOfPageContent）； 　　} 　　pdfReader.Close（）； 　　return text; 　　} 　　catch （Exception ex） 　　{ 　　StreamWriter wlog = File.AppendText（System.AppDomain.CurrentDomain.SetupInformation.ApplicationBase+"\\mylog.log"）； 　　wlog.WriteLine（"出错文件：" + e.FullPath + "原因：" + ex.ToString（））； 　　wlog.Flush（）； 　　wlog.Close（）；return null; 　　}
iTextsharp 5.5.13.1 API帮助.zip
05-16
iTextsharp 5.5.13.1 API帮助，全英文，没有汉字
pb调用iTextSharp提示空函数
12-13
在使用PowerBuilder（PB）调用iTextSharp库时，如果提示空函数错误，可能是由于以下几个原因导致的： 1. **引用未正确添加**：确保在PB项目中正确添加了对iTextSharp库的引用。可以尝试重新添加引用并确认引用路径正确。 2. **函数名或参数不匹配**：检查PB中调用的函数名和参数是否与iTextSharp库中的函数名和参数完全匹配。函数名拼写错误或参数类型不匹配都会导致空函数错误。 3. **缺少必要的初始化**：某些库在使用前需要进行初始化操作。确保在调用iTextSharp函数之前，已经正确初始化了相关的对象或资源。 4. **版本不兼容**：确认使用的iTextSharp版本与PB项目兼容。不同版本的库可能会有不同的函数签名或功能。 5. **权限问题**：确保应用程序有足够的权限访问iTextSharp库文件。某些系统可能会限制对特定目录或文件的访问。 以下是一个简单的示例，展示如何在PB中调用iTextSharp库生成PDF文件： ```pb // 声明iTextSharp库中的PdfWriter对象 PdfWriter lnv_pdfWriter // 声明iTextSharp库中的Document对象 Document lnv_document // 声明文件流对象 FileStream lnv_fileStream // 创建一个新的PDF文件 lnv_fileStream = CREATE FileStream("C:\example.pdf", LineMode!, Write!, LockReadWrite!) // 创建一个新的Document对象 lnv_document = CREATE Document(lnv_fileStream) // 创建一个新的PdfWriter对象 lnv_pdfWriter = CREATE PdfWriter.GetInstance(lnv_document, lnv_fileStream) // 打开文档 lnv_document.Open() // 添加内容到文档 lnv_document.Add(Paragraph("Hello, iTextSharp!")) // 关闭文档 lnv_document.Close() // 清理资源 DESTROY lnv_pdfWriter DESTROY lnv_document DESTROY lnv_fileStream ```
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值