zoukankan      html  css  js  c++  java
  • 一步一步ITextSharp 低级操作函数使用

    首先说一下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

  • 相关阅读:
    日报 18/05/29
    jsvascript === 和==的区别
    分享个数组
    ROC曲线绘制
    DLL中传递STL参数(如Vector或者list等)会遇到的问题[转载]
    利用JAX-WS 开发web服务
    菜鸟的成长之路——在清华特奖经验分享交流会上的演讲
    一段小代码的思考
    关于Vector中的元素中含有指针成员的情况
    关于职业规划——好帖【转载】
  • 原文地址:https://www.cnblogs.com/Alex80/p/8836562.html
Copyright © 2011-2022 走看看