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

最新推荐文章于 2025-06-11 14:27:39 发布

5号旁白

最新推荐文章于 2025-06-11 14:27:39 发布

阅读量1.3k

点赞数

分类专栏： itextpdf html_ _ _

itextpdf 同时被 2 个专栏收录

1 篇文章

订阅专栏

html_ _ _

1 篇文章

订阅专栏

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

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

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

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

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

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

图形和文本状态解释

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

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

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

1、PdfContentByte.ShowTextAligned()

方法签名如下：

 
public void ShowTextAligned(int alignment, String text, float x,  
float y, float rotation) 
public void ShowTextAlignedKerned(int alignment, String text, 
 float x, float y, float rotation)  
  

参数说明：

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

text：要输出的文本

x:文本输入的X坐标

y:文本输入的Y坐标

rotation:文本的旋转角度

实例：

代码：

 
public class TextRotaiDemo : TestBase 
    { 
        protected override void WriteDocument(Document document, PdfWriter writer) 
        { 
            var direct = writer.DirectContent; 
            direct.SaveState();//保存当前的输出状态 
            String foobar = "ShowTextAligned演示"; 
   
            direct.BeginText(); 
            direct.SetFontAndSize(Normal.BaseFont, 12); 
            direct.ShowTextAligned(Element.ALIGN_LEFT, foobar, 400, 788, 0); 
            direct.ShowTextAligned(Element.ALIGN_RIGHT, foobar, 400, 752, 0); 
            direct.ShowTextAligned(Element.ALIGN_CENTER, foobar, 400, 716, 0); 
            direct.ShowTextAligned(Element.ALIGN_CENTER, foobar, 400, 680, 30); 
            direct.ShowTextAligned(Element.ALIGN_LEFT, foobar, 400, 644, 0); 
            direct.EndText(); 
            direct.RestoreState();//恢复输出状态 
        } 
    } 
  

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

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

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

 
public static void ShowTextAligned(PdfContentByte canvas, int alignment,  
Phrase phrase, float x, float y, float rotation) 
public static void ShowTextAligned(PdfContentByte canvas, int alignment,  
Phrase phrase, float x, float y, float rotation, int runDirection, int arabicOptions) 
  

canvas:层对象

alignment:对齐方式

phrase:待写入对象

x:坐标x

y:坐标y

rotation:旋转角度

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

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

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

演示实例如下：

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

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

代码如下：

 
public class ColumnTextShowTextAlignedDemo : TestBase 
    { 
        protected override void WriteDocument(Document document, PdfWriter writer) 
        { 
            var foobar = new Phrase("Show Text Aligned 演示",Normal); 
   
            var direct = writer.DirectContent; 
            ColumnText.ShowTextAligned(direct,Element.ALIGN_LEFT, foobar, 400, 788, 0); 
            ColumnText.ShowTextAligned(direct, Element.ALIGN_RIGHT, foobar, 400, 752, 0); 
            ColumnText.ShowTextAligned(direct, Element.ALIGN_CENTER, foobar, 400, 716, 0); 
            ColumnText.ShowTextAligned(direct, Element.ALIGN_CENTER, foobar, 400, 680, 30); 
            ColumnText.ShowTextAligned(direct, Element.ALIGN_LEFT, foobar, 400, 644, 0); 
   
   
            ColumnText.ShowTextAligned(direct, Element.ALIGN_LEFT, foobar, 400, 488, 0, PdfWriter.RUN_DIRECTION_NO_BIDI, 0); 
            ColumnText.ShowTextAligned(direct, Element.ALIGN_RIGHT, foobar, 400, 452, 0, PdfWriter.RUN_DIRECTION_NO_BIDI, 0); 
            ColumnText.ShowTextAligned(direct, Element.ALIGN_CENTER, foobar, 400, 416, 0, PdfWriter.RUN_DIRECTION_LTR, 0); 
            ColumnText.ShowTextAligned(direct, Element.ALIGN_CENTER, foobar, 400, 380, 30, PdfWriter.RUN_DIRECTION_DEFAULT, 0); 
            ColumnText.ShowTextAligned(direct, Element.ALIGN_LEFT, foobar, 400, 344, 0, PdfWriter.RUN_DIRECTION_NO_BIDI, 1); 
        } 
    } 
  

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.

）

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

■ PdfContentByte.TEXT_RENDER_MODE_FILL_STROKE—

■ PdfContentByte.TEXT_RENDER_MODE_INVISIBLE—文本不可见

效果如下：

代码如下：

 
public class ChunkScalSekewDemo : TestBase 
    { 
        protected override void WriteDocument(Document document, PdfWriter writer) 
        { 
            var foobar = "Show Text Aligned 演示"; 
            var direct = writer.DirectContent; 
            var c = new Chunk(foobar, Normal); 
            c.SetHorizontalScaling(0.5f); 
            var phrase = new Phrase(c); 
            ColumnText.ShowTextAligned(direct,Element.ALIGN_LEFT, phrase, 400, 572, 0); 
            c = new Chunk(foobar, Normal); 
            c.SetSkew(15, 15); 
            phrase = new Phrase(c); 
            ColumnText.ShowTextAligned(direct,Element.ALIGN_LEFT, phrase, 400, 536, 0); 
            c = new Chunk(foobar, Normal); 
            c.SetSkew(0, 25); 
            phrase = new Phrase(c); 
            ColumnText.ShowTextAligned(direct,Element.ALIGN_LEFT, phrase, 400, 500, 0); 
            c = new Chunk(foobar, Normal); 
            c.SetTextRenderMode( 
              PdfContentByte.TEXT_RENDER_MODE_STROKE,0.1f, BaseColor.RED); 
            phrase = new Phrase(c); 
            ColumnText.ShowTextAligned(direct,Element.ALIGN_LEFT, phrase, 400, 464, 0); 
            c = new Chunk(foobar, Normal); 
            c.SetTextRenderMode(PdfContentByte.TEXT_RENDER_MODE_FILL_STROKE, 1, null); 
            phrase = new Phrase(c); 
            ColumnText.ShowTextAligned(direct, 
              Element.ALIGN_LEFT, phrase, 400, 428, -0); 
        } 
    } 
  

4、ColumnText对象使用

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

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

1、SetSimpleColumn

 
public void SetSimpleColumn(float llx, float lly, float urx, float ury) 
public void SetSimpleColumn(float llx, float lly, float urx, float ury,  
float leading, int alignment) 
public void SetSimpleColumn(Phrase phrase, float llx, float lly,  
float urx, float ury, float leading, int alignment) 
  

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

2、AddText

 
public void AddText(Chunk chunk) 
public void AddText(Phrase phrase)

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

3、AddElement

 
public void AddElement(IElement element) 
  

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

4、HasMoreText

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

5、Go

 
public int Go() 
public int Go(bool simulate)

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

simulate表示是否模拟写入

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

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

重要属性：

Alignment：对齐方式

ExtraParagraphSpace

Leading：间距

Indent：缩进

RightIndent：右缩进

SpaceCharRatio：在使用“justified”时使用