其他分享
首页 > 其他分享> > 详解开源免费且稳定实用的.NET PDF打印组件itextSharp

详解开源免费且稳定实用的.NET PDF打印组件itextSharp

作者:互联网

详解开源免费且稳定实用的.NET PDF打印组件itextSharp

于 2020-11-12 11:32:51 发布2785 收藏 7 文章标签: pdf itextsharp c# 版权

提到打印,恐怕对于很多人都不会陌生,无论是开发者,还是非计算机专业的人员都会接触到打印。对于项目开发中使用到打印的地方会非常多,在.NET项目中,选择打印的方式比较多,例如原始的IE网页打印、水晶报表、JS插件实现打印、导出文档打印,以及今天提到的使用itextSharp组件实现PDF打印等等。

 在.NET中实现PDF打印的组件比较多,例如PDFsharp、Report.NET、sharpPDF、itextSharp等等,今天主要简单的介绍itextSharp组件。

零、什么是PDF?

PDF(Portable Document Format的简称,意为“可携带文档格式/可移植文档格式”),是由Adobe Systems用于与应用程序操作系统硬件无关的方式进行文件交换所发展出的文件格式。PDF文件以PostScript语言图象模型为基础,无论在哪种打印机上都可保证精确的颜色和准确的打印效果,即PDF会忠实地再现原稿的每一个字符、颜色以及图象。

一、itextSharp组件概述:

1.iText的是PDF库,它允许你创建,调整,检查和维护的可移植文档格式文件(PDF):

  (1)基于从XML文件或数据库中的数据生成文件和报告。

  (2)创建地图和书籍,利用众多的互动在PDF可用的功能。

  (3)添加书签,页码,水印等功能,以现有的PDF文件。

  (4).从现有PDF文件拆分或连接页面;填写交互式表单。

  (5).即成动态生成或操纵PDF文档到Web浏览器。

 iText所使用的的Java,.NET,Android和GAE开发人员加强与PDF功能的应用程序。iTextSharp的是.NET端口。

 2.itextSharp的一些特征:

(1).PDF生成。

(2).PDF操作(冲压水印,合并/拆分PDF文件,...)。

(3).PDF表单填写。

(4).XML功能。

(5).数字签名。

以上是对itextSharp组件的一些特性的简单介绍,如果需要更加深入的了解itextSharp组件的相关信息,可以细致的查看API文档和itextSharp产品介绍。https://sourceforge.net/projects/itextsharp/#overview。

二.itextSharp组件核心类和方法:

谈到打印,在我们的项目中需要首先考虑的是我们需要打印的东西是什么。在大脑里面应该首先有一个文档的概念,在我们编程的过程中,“文档”这个词无处不在,这个可以是一个宽泛的概念,也可以是一个狭窄的概念,宽泛的“文档”是指容器,用以存放一些元素;狭窄的“文档”是指实际的文件类型。

对于打印的“文档”,具体看一下宽泛的概念,文档包含元素和节点等等。在组织打印的时候,我们需要创建文档,写入元素和节点等信息,最后组合成为我们需要打印的内容。itextSharp组件可以插入段落、表格、图片等等信息,可以很方便的完成我们需要完成的功能。

Paragraph:报表中的文本;Image:报表中的图片;PdfPTable:表格;PdfPCell:单元格。

1.Document类Open()方法:打开文档对象。

  1.   public virtual void Open(){
  2.   if (!this.close)
  3.   {
  4.   this.open = true;
  5.   }
  6.   foreach (IDocListener listener in this.listeners)
  7.   {
  8.   listener.SetPageSize(this.pageSize);
  9.   listener.SetMargins(this.marginLeft, this.marginRight, this.marginTop, this.marginBottom);
  10.   listener.Open();
  11.   }
  12.   }

以上的代码可以看到,我们在打开文档的时候,会设置文档大小,文档页边距等信息。

2.Paragraph类Add()方法:向段落添加元素。

  1.   public override bool Add(IElement o)
  2.   {
  3.   if(o is List)
  4.   {
  5.   List element = (List) o;
  6.   element.IndentationLeft += this.indentationLeft;
  7.   element.IndentationRight = this.indentationRight;
  8.   base.Add(element);
  9.   return true;
  10.   }
  11.   if(o is Image)
  12.   {
  13.   base.AddSpecial((Image) o);
  14.   return true;
  15.   }
  16.   if(o is Paragraph)
  17.   {
  18.   base.Add(o);
  19.   IList < Chunk > chunks = this.Chunks;
  20.   if(chunks.Count > 0)
  21.   {
  22.   Chunk chunk = chunks[chunks.Count - 1];
  23.   base.Add(new Chunk("\n", chunk.Font));
  24.   }
  25.   else
  26.   {
  27.   base.Add(Chunk.NEWLINE);
  28.   }
  29.   return true;
  30.   }
  31.   base.Add(o);
  32.   return true;
  33.   }
  34.   public interface IElement
  35.   {
  36.   bool IsContent();
  37.   bool IsNestable();
  38.   bool Process(IElementListener listener);
  39.   string ToString(); // Properties
  40.   IList < Chunk > Chunks
  41.   {
  42.   get;
  43.   }
  44.   int Type
  45.   {
  46.   get;
  47.   }
  48.   }

以上的add()方法是向段落添加元素,我们可以看到参数是个接口“IElement”,我们接下来看一下这个接口,接口主要元素是块。我们看到在向段落添加元素时,可以添加List,Image,Paragraph,Chunk。

3.Image.GetInstance()获取图片实例。

  1.   public static Image GetInstance(Image image)
  2.   {
  3.   if(image == null)
  4.   {
  5.   return null;
  6.   }
  7.   return(Image) image.GetType().GetConstructor(BindingFlags.Public | BindingFlags.Instance, null, new Type[]
  8.   {
  9.   typeof(Image)
  10.   }, null).Invoke(new object[]
  11.   {
  12.   image
  13.   });
  14.   }
  15.   public static Image GetInstance(byte[] imgb)
  16.   {
  17.   int num = imgb[0];
  18.   int num2 = imgb[1];
  19.   int num3 = imgb[2];
  20.   int num4 = imgb[3];
  21.   if(((num == 0x47) && (num2 == 0x49)) && (num3 == 70))
  22.   {
  23.   GifImage image = new GifImage(imgb);
  24.   return image.GetImage(1);
  25.   }
  26.   if((num == 0xff) && (num2 == 0xd8))
  27.   {
  28.   return new Jpeg(imgb);
  29.   }
  30.   if(((num == 0) && (num2 == 0)) && ((num3 == 0) && (num4 == 12)))
  31.   {
  32.   return new Jpeg2000(imgb);
  33.   }
  34.   if(((num == 0xff) && (num2 == 0x4f)) && ((num3 == 0xff) && (num4 == 0x51)))
  35.   {
  36.   return new Jpeg2000(imgb);
  37.   }
  38.   if(((num == PngImage.PNGID[0]) && (num2 == PngImage.PNGID[1])) && ((num3 == PngImage.PNGID[2]) && (num4 == PngImage.PNGID[3])))
  39.   {
  40.   return PngImage.GetImage(imgb);
  41.   }
  42.   if((num == 0xd7) && (num2 == 0xcd))
  43.   {
  44.   return new ImgWMF(imgb);
  45.   }
  46.   if((num == 0x42) && (num2 == 0x4d))
  47.   {
  48.   return BmpImage.GetImage(imgb);
  49.   }
  50.   if((((num == 0x4d) && (num2 == 0x4d)) && ((num3 == 0) && (num4 == 0x2a))) || (((num == 0x49) && (num2 == 0x49)) && ((num3 == 0x2a) && (num4 == 0))))
  51.   {
  52.   RandomAccessFileOrArray s = null;
  53.   try
  54.   {
  55.   s = new RandomAccessFileOrArray(imgb);
  56.   Image tiffImage = TiffImage.GetTiffImage(s, 1);
  57.   if(tiffImage.OriginalData == null)
  58.   {
  59.   tiffImage.OriginalData = imgb;
  60.   }
  61.   return tiffImage;
  62.   }
  63.   finally
  64.   {
  65.   if(s != null)
  66.   {
  67.   s.Close();
  68.   }
  69.   }
  70.   }
  71.   throw new IOException(MessageLocalization.GetComposedMessage("the.byte.array.is.not.a.recognized.imageformat"));
  72.   }

该方法根据参数获取图片实例的方式比较多,例如:Image,PdfTemplate,PRIndirectReference,byte[],Stream,string ,Uri等等,以上给出了根据Image和byte[]获取ItextSharp的image实例。

 4.Image的ScaleAbsolute():设置图片信息。

  1.   public void ScaleAbsolute(float newWidth, float newHeight)
  2.   {
  3.   this.plainWidth = newWidth;
  4.   this.plainHeight = newHeight;
  5.   float[] matrix = this.Matrix;
  6.   this.scaledWidth = matrix[6] - matrix[4];
  7.   this.scaledHeight = matrix[7] - matrix[5];
  8.   this.WidthPercentage = 0 f;
  9.   }

 以上代码可以看出,设置图片的信息主要包括高度、宽度、排列等信息。

 5.Anchor类的Process()方法:重写链接的处理方法。

  1.   public override bool Process(IElementListener listener)
  2.   {
  3.   try
  4.   {
  5.   bool flag = (this.reference != null) && this.reference.StartsWith("#");
  6.   bool flag2 = true;
  7.   foreach(Chunk chunk in this.Chunks)
  8.   {
  9.   if(((this.name != null) && flag2) && !chunk.IsEmpty())
  10.   {
  11.   chunk.SetLocalDestination(this.name);
  12.   flag2 = false;
  13.   }
  14.   if(flag)
  15.   {
  16.   chunk.SetLocalGoto(this.reference.Substring(1));
  17.   }
  18.   else if(this.reference != null)
  19.   {
  20.   chunk.SetAnchor(this.reference);
  21.   }
  22.   listener.Add(chunk);
  23.   }
  24.   return true;
  25.   }
  26.   catch(DocumentException)
  27.   {
  28.   return false;
  29.   }
  30.   }

以上方法可以看到,该方法是在本类中被重写,用以处理链接的相关信息。

6.PageSize:设置纸张的类型。

  1.   public class PageSize
  2.   { // Fields
  3.   public static readonly Rectangle _11X17;
  4.   public static readonly Rectangle A0;
  5.   public static readonly Rectangle A1;
  6.   public static readonly Rectangle A10;
  7.   public static readonly Rectangle A2;
  8.   public static readonly Rectangle A3;
  9.   public static readonly Rectangle A4;
  10.   public static readonly Rectangle A4_LANDSCAPE;
  11.   public static readonly Rectangle A5;
  12.   public static readonly Rectangle A6;
  13.   public static readonly Rectangle A7;
  14.   public static readonly Rectangle A8;
  15.   public static readonly Rectangle A9;
  16.   public static readonly Rectangle ARCH_A;
  17.   public static readonly Rectangle ARCH_B;
  18.   public static readonly Rectangle ARCH_C;
  19.   public static readonly Rectangle ARCH_D;
  20.   public static readonly Rectangle ARCH_E;
  21.   public static readonly Rectangle B0;
  22.   public static readonly Rectangle B1;
  23.   public static readonly Rectangle B10;
  24.   public static readonly Rectangle B2;
  25.   public static readonly Rectangle B3;
  26.   public static readonly Rectangle B4;
  27.   public static readonly Rectangle B5;
  28.   public static readonly Rectangle B6;
  29.   public static readonly Rectangle B7;
  30.   public static readonly Rectangle B8;
  31.   public static readonly Rectangle B9;
  32.   public static readonly Rectangle CROWN_OCTAVO;
  33.   public static readonly Rectangle CROWN_QUARTO;
  34.   public static readonly Rectangle DEMY_OCTAVO;
  35.   public static readonly Rectangle DEMY_QUARTO;
  36.   public static readonly Rectangle EXECUTIVE;
  37.   public static readonly Rectangle FLSA;
  38.   public static readonly Rectangle FLSE;
  39.   public static readonly Rectangle HALFLETTER;
  40.   public static readonly Rectangle ID_1;
  41.   public static readonly Rectangle ID_2;
  42.   public static readonly Rectangle ID_3;
  43.   public static readonly Rectangle LARGE_CROWN_OCTAVO;
  44.   public static readonly Rectangle LARGE_CROWN_QUARTO;
  45.   public static readonly Rectangle LEDGER;
  46.   public static readonly Rectangle LEGAL;
  47.   public static readonly Rectangle LEGAL_LANDSCAPE;
  48.   public static readonly Rectangle LETTER;
  49.   public static readonly Rectangle LETTER_LANDSCAPE;
  50.   public static readonly Rectangle NOTE;
  51.   public static readonly Rectangle PENGUIN_LARGE_PAPERBACK;
  52.   public static readonly Rectangle PENGUIN_SMALL_PAPERBACK;
  53.   public static readonly Rectangle POSTCARD;
  54.   public static readonly Rectangle ROYAL_OCTAVO;
  55.   public static readonly Rectangle ROYAL_QUARTO;
  56.   public static readonly Rectangle SMALL_PAPERBACK;
  57.   public static readonly Rectangle TABLOID;
  58.   // Methods
  59.   static PageSize();
  60.   public PageSize();
  61.   public static Rectangle GetRectangle(string name);
  62.   }

以上的类中,我们可以看到我们可以设置需要打印的纸张类型,根据实际情况可以选择。在最下面我们看到了两种方法,一个是PageSize()设置纸张大小,一个是GetRectangle()绘制矩形。

以上是对itextSharp组件的一些类和方法的简单介绍,对于表格,单元格等等类的介绍就不再继续,有兴趣的可以自己查看源代码信息。

三.itextSharp组件实例:

上面介绍了itextSharp组件的背景、特性,以及组件的核心类和方法,在这里给出一个简单的itextSharp组件操作的实例,这个实例只是一个简单的介绍。

  1.   /// <summary> /// 字体 /// </summary>
  2.   private Font _font;
  3.   /// <summary> /// 文档大小 /// </summary>
  4.   private Rectangle _rect;
  5.   /// <summary> /// 文档对象 /// </summary>
  6.   private readonly Document _document;
  7.   /// <summary> /// 基础字体 /// </summary>
  8.   private BaseFont _basefont;
  9.   /// <summary> /// 构造函数 /// </summary>
  10.   public PDFOperation()
  11.   {
  12.   _rect = PageSize.A4;
  13.   _document = new Document(_rect);
  14.   }
  15.   /// <summary> /// 构造函数 /// </summary>
  16.   /// <param name="type">页面大小(如"A4")</param>
  17.   public PDFOperation(string type)
  18.   {
  19.   if(string.IsNullOrEmpty(type))
  20.   {
  21.   throw new ArgumentNullException(type);
  22.   }
  23.   SetPageSize(type);
  24.   _document = new Document(_rect);
  25.   }
  26.   /// <summary> /// 构造函数 /// </summary>
  27.   /// <param name="type">页面大小(如"A4")</param>
  28.   /// <param name="marginLeft">内容距左边框距离</param>
  29.   /// <param name="marginRight">内容距右边框距离</param>
  30.   /// <param name="marginTop">内容距上边框距离</param>
  31.   /// <param name="marginBottom">内容距下边框距离</param>
  32.   public PDFOperation(string type, float marginLeft, float marginRight, float marginTop, float marginBottom)
  33.   {
  34.   if(string.IsNullOrEmpty(type))
  35.   {
  36.   throw new ArgumentNullException(type);
  37.   }
  38.   SetPageSize(type);
  39.   _document = new Document(_rect, marginLeft, marginRight, marginTop, marginBottom);
  40.   }
  41.   /// <summary> /// 设置字体 /// </summary>
  42.   public void SetBaseFont(string path)
  43.   {
  44.   if(string.IsNullOrEmpty(path))
  45.   {
  46.   throw new ArgumentNullException(path);
  47.   }
  48.   _basefont = BaseFont.CreateFont(path, BaseFont.IDENTITY_H, BaseFont.NOT_EMBEDDED);
  49.   }
  50.   /// <summary> /// 设置字体 /// </summary>
  51.   /// <param name="size">字体大小</param>
  52.   public void SetFont(float size)
  53.   {
  54.   _font = new Font(_basefont, size);
  55.   }
  56.   /// <summary> /// 设置页面大小 /// </summary>
  57.   /// <param name="type">页面大小(如"A4")</param>
  58.   public void SetPageSize(string type)
  59.   {
  60.   if(string.IsNullOrEmpty(type))
  61.   {
  62.   throw new ArgumentNullException(type);
  63.   }
  64.   switch(type.Trim())
  65.   {
  66.   //枚举需要的文档纸张大小
  67.   case "A3":
  68.   _rect = PageSize.A3;
  69.   break;
  70.   case "A4":
  71.   _rect = PageSize.A4;
  72.   break;
  73.   case "A8":
  74.   _rect = PageSize.A8;
  75.   break;
  76.   }
  77.   }
  78.   /// <summary> /// 实例化文档 /// </summary>
  79.   /// <param name="os">文档相关信息(如路径,打开方式等)</param>
  80.   public void GetInstance(Stream os)
  81.   {
  82.   if(os == null)
  83.   {
  84.   throw new ArgumentNullException("os");
  85.   }
  86.   PdfWriter.GetInstance(_document, os);
  87.   }
  88.   /// <summary> /// 打开文档对象 /// </summary>
  89.   /// <param name="os">文档相关信息(如路径,打开方式等)</param>
  90.   public void Open(Stream os)
  91.   {
  92.   if(os == null)
  93.   {
  94.   throw new ArgumentNullException("os");
  95.   }
  96.   GetInstance(os);
  97.   _document.Open();
  98.   }
  99.   /// <summary> /// 关闭打开的文档 /// </summary>
  100.   public void Close()
  101.   {
  102.   _document.Close();
  103.   }
  104.   /// <summary> /// 添加段落 /// </summary>
  105.   /// <param name="content">内容</param>
  106.   /// <param name="fontsize">字体大小</param>
  107.   public void AddParagraph(string content, float fontsize)
  108.   {
  109.   SetFont(fontsize);
  110.   var pra = new Paragraph(content, _font);
  111.   _document.Add(pra);
  112.   }
  113.   /// <summary> /// 添加段落 /// </summary>
  114.   /// <param name="content">内容</param>
  115.   /// <param name="fontsize">字体大小</param>
  116.   /// <param name="alignment">对齐方式(1为居中,0为居左,2为居右)</param>
  117.   /// <param name="spacingAfter">段后空行数(0为默认值)</param>
  118.   /// <param name="spacingBefore">段前空行数(0为默认值)</param>
  119.   /// <param name="multipliedLeading">行间距(0为默认值)</param>
  120.   public void AddParagraph(string content, float fontsize, int alignment, float spacingAfter, float spacingBefore, float multipliedLeading)
  121.   {
  122.   SetFont(fontsize);
  123.   var pra = new Paragraph(content, _font)
  124.   {
  125.   Alignment = alignment
  126.   };
  127.   if(spacingAfter != 0)
  128.   {
  129.   pra.SpacingAfter = spacingAfter;
  130.   }
  131.   if(spacingBefore != 0)
  132.   {
  133.   pra.SpacingBefore = spacingBefore;
  134.   }
  135.   if(multipliedLeading != 0)
  136.   {
  137.   pra.MultipliedLeading = multipliedLeading;
  138.   }
  139.   _document.Add(pra);
  140.   }
  141.   /// <summary> /// 添加图片 /// </summary>
  142.   /// <param name="path">图片路径</param>
  143.   /// <param name="alignment">对齐方式(1为居中,0为居左,2为居右)</param>
  144.   /// <param name="newWidth">图片宽(0为默认值,如果宽度大于页宽将按比率缩放)</param>
  145.   /// <param name="newHeight">图片高</param>
  146.   public void AddImage(string path, int alignment, float newWidth, float newHeight)
  147.   {
  148.   if(string.IsNullOrEmpty(path))
  149.   {
  150.   throw new ArgumentNullException(path);
  151.   }
  152.   var img = Image.GetInstance(path);
  153.   img.Alignment = alignment;
  154.   // ReSharper disable once CompareOfFloatsByEqualityOperator
  155.   if(newWidth != 0)
  156.   {
  157.   img.ScaleAbsolute(newWidth, newHeight);
  158.   }
  159.   else
  160.   {
  161.   if(img.Width > PageSize.A4.Width)
  162.   {
  163.   img.ScaleAbsolute(_rect.Width, img.Width * img.Height / _rect.Height);
  164.   }
  165.   }
  166.   _document.Add(img);
  167.   }
  168.   /// <summary> /// 添加链接 /// </summary>
  169.   /// <param name="content">链接文字</param>
  170.   /// <param name="fontSize">字体大小</param>
  171.   /// <param name="reference">链接地址</param>
  172.   public void AddAnchorReference(string content, float fontSize, string reference)
  173.   {
  174.   if(string.IsNullOrEmpty(content))
  175.   {
  176.   throw new ArgumentNullException(content);
  177.   }
  178.   SetFont(fontSize);
  179.   var auc = new Anchor(content, _font)
  180.   {
  181.   Reference = reference
  182.   };
  183.   _document.Add(auc);
  184.   }
  185.   /// <summary> /// 添加链接点 /// </summary>
  186.   /// <param name="content">链接文字</param>
  187.   /// <param name="fontSize">字体大小</param>
  188.   /// <param name="name">链接点名</param>
  189.   public void AddAnchorName(string content, float fontSize, string name)
  190.   {
  191.   if(string.IsNullOrEmpty(content))
  192.   {
  193.   throw new ArgumentNullException(content);
  194.   }
  195.   SetFont(fontSize);
  196.   var auc = new Anchor(content, _font)
  197.   {
  198.   Name = name
  199.   };
  200.   _document.Add(auc);
  201.   }

以上的实例比较的简单,主要是用作简单介绍组件的用法。如果需要将组件设计的更加通用,我们可以将组件的相关类和方法重写,并且可以开发一套cs或者bs程序,实现组件的图形化操作,图形化操作生成文件模板。文件模板可以将相关信息序列化(json或者二进制),在项目中直接加载模型,并将数据绑定在模板中,实现pdf打印的动态配置。

这个程序的开发难度一般,如果有兴趣的可以自行开发一套工具,可以更好的实现我们的项目pdf打印功能。

四、基本使用步骤和常见用法,一般分为5个步骤

一、需要创建一个Document实例。

一共有三个构造方法

  1.   public Document();
  2.   public Document(Rectangle pageSize);
  3.   public Document(Rectangle pageSize,int marginLeft,int marginRight,int marginTop,int marginBottom);

第一个构造函数以A4页面作为参数调用第二个构造函数,第二个构造函数以每边36磅页边距为参数调用第三个构造函数。

我们可以自定义页面的大小,颜色,比如:

  1.   // 设置大小
  2.   Rectangle pageSize = new Rectangle(300, 500);
  3.   // 设置背景颜色
  4.   pageSize.setBackgroundColor(new BaseColor(0xFF, 0xFF, 0xDE));
  5.   // 设置边框颜色
  6.   pageSize.setBorderColor(new BaseColor(0xFF, 0xFF, 0xDE));
  7.   Document document = new Document(pageSize);

但是,通常不需要我们设置,系统有很多尺寸可以选择,在PageSize类下面

我们最常用的就是A4,无参数构造的时候默认使用的A4尺寸配置,所以很多情况下,我们不需要构造页面的尺寸,大部分情况我们都是使用的纵向页面,如果特殊情况需要使用横向页面,只需要将其翻转就可以了

		Document document = new Document(PageSize.A4.rotate());

另外,如果有指定边距的需求时,我们还可以定义其边距

		Document document = new Document(PageSize.A5, 40, 70, 100, 200);

边距默认以磅为单位,默认边距是36磅,至于和厘米,英寸等其它单位的换算这里就不详细介绍了,注意一点就是,边距是针对整个文件生效的,故慎用,如果没有特别需求,使用默认的就可以了。

那么第一步创建Document实例,基本使用就这样了,接下来进入第二步

二、创建Writer实例

这里介绍的pdf,所以这里就直接使用的DocWriter的实现类PdfWriter,常见用法如下:

  1.   // 创建PdfWriter对象
  2.   PdfWriter writer = PdfWriter.getInstance(document, new FileOutputStream(outPath));

第二个参数可以是任何一种流,这里只是取一种常见的来使用。

我们还可以设置行间距

  1.   // 设置每行的间距
  2.   writer.setInitialLeading(30);

三、打开Document

在写入实际内容前,我们通常需要设置文件的一些属性,比如作者、标题、摘要等,下面直接上代码:

  1.   // 作者
  2.   document.addAuthor("feng");
  3.   // 创建日期
  4.   document.addCreationDate();
  5.   // 创建关键字
  6.   document.addKeywords("测试");
  7.   // 创建生产商,自动使用iText
  8.   document.addProducer();
  9.   // 创建程序
  10.   document.addCreator("www.ydc51.com");
  11.   // 标题
  12.   document.addTitle("测试标题");
  13.   // 主题
  14.   document.addSubject("测试PDF创建的主题");

上面有详细的注释,就不做多的说明了

然后打开文档就一句代码

  1.   // 打开文档
  2.   document.open();

四、添加内容

上面做好了充分准备后,下面就添加实际内容了,在添加内容之前,非常有必要了解一下字体,这是内容的基础,为了支持中文我们需要对字体做一些处理,有三种方式支持中文:

1、使用Windows系统字体(TrueType),引用Window系统自带的字体

  1.   // 方式一:使用Windows系统字体(TrueType)
  2.   BaseFont baseFont = BaseFont.createFont("C:/Windows/Fonts/SIMYOU.TTF", BaseFont.IDENTITY_H,
  3.   BaseFont.NOT_EMBEDDED);

2、使用自己的资源字体

  1.   // 方式二:使用资源字体(ClassPath)
  2.   BaseFont baseFont = BaseFont.createFont("/SIMYOU.TTF", BaseFont.IDENTITY_H, BaseFont.NOT_EMBEDDED);

3、使用iTextAsian.jar中的字体

  1.   // 方式三:使用iTextAsian.jar中的字体
  2.   BaseFont baseFont = BaseFont.createFont("STSong-Light", "UniGB-UCS2-H", BaseFont.NOT_EMBEDDED);

在这个库中有很多字体可以使用,需要注意的是这里有一个坑,在itext5.x版本对font和encoding文件都是从 RESOURCE_PATH = “com/itextpdf/text/pdf/fonts/”加载的,而itextasian1.5.x.jar的包名是com.lowagie.text.pdf.fonts, 包名不一致,导致路径错误

这里可以将itextasian1.5.x.jar解压,找到里面itextasian1.5.x/com里的lowagie文件,将lowagie该名为:itextpdf

然后重新打包,网上有很多解决办法,这里随便贴一个地址:https://blog.csdn.net/sanqima/article/details/50374151

好,使用上面其中任意一种作为基本字体就可以解决中文问题,然后我们可以对自己使用的字体进行一些设置颜色,字体大小、类型等等

  1.   Font font = new Font(baseFont);
  2.   // 设置字体大小
  3.   font.setSize(13);
  4.   // 设置字体颜色
  5.   font.setColor(new BaseColor(255, 0, 0));
  6.   // 设置类型,为正常
  7.   font.setStyle(Font.NORMAL);
  8.   // 设置类型,加粗
  9.   font.setStyle(Font.BOLD);
  10.   // 设置类型,倾斜
  11.   font.setStyle(Font.ITALIC);
  12.   // 设置类型,下划线
  13.   font.setStyle(Font.UNDERLINE);
  14.   // 设置类型,可组合,倾斜+删除线
  15.   font.setStyle(Font.ITALIC | Font.STRIKETHRU);

上面有非常详细的注释,到目前字体设置基本够用了

添加内容

Paragraph paragraph = new Paragraph(content, font);

Paragraph是段落,段落是一系列块和(或)短句。同短句一样,段落有确定的间距。用户还可以指定缩排;在边和(或)右边保留一定空白,段落可以左对齐、右对齐和居中对齐。添加到文档中的每一个段落将自动另起一行。

上面有提到一种块Chunk,块(Chunk)是能被添加到文档的文本的最小单位,块可以用于构建其他基础元素如短句、段落、锚点等,块是一个有确定字体的字符串,要添加块到文档中时,其他所有布局变量均要被定义。使用方法如下:

  1.   // 块
  2.   Chunk chunk = new Chunk("语句块");
  3.   // 设置字体,字体定宽
  4.   chunk.setFont(font);
  5.   // 设置背景颜色
  6.   chunk.setBackground(new BaseColor(0xFF, 0xFF, 0x00));
  7.   //使用块来构造段落
  8.   Paragraph paragraph = new Paragraph(chunk);

Chunk还有一些常用作用,使用块来换行,设置上标下标

  1.   // 设置上标下标
  2.   chunk.setTextRise(6f);
  3.   // 使用Chunk换行
  4.   document.add(Chunk.NEWLINE);

还有一种叫短句Phrase,短句(Phrases)是一系列以特定间距(两行之间的距离)作为参数的块,一个短句有一个主字体,但短句中的一些块具有不同于主字体的字体,你有更多的选择去创建短句,使用方式如下:

  1.   // 短句
  2.   Phrase phrase = new Phrase(content);
  3.   // 设置字体
  4.   phrase.setFont(font);
  5.   // 设置间距
  6.   phrase.setLeading(30f);
  7.   // 使用短句来构造段落
  8.   Paragraph paragraph2 = new Paragraph(phrase);

段落还有个设置方法,作用是尽可能将一个段落放在同一页中,该方法并不是始终有效

  1.   // 试图将一个段落放在同一页中,该方法并不是始终有效
  2.   paragraph.setKeepTogether(true);

那么,段落的构造就差不多了,然后就是将段落加载到Document中:

document.add(paragraph);

五、第五步就是关闭文档了,关闭 document 非常重要, 因为它将关闭正在运行的Writer并将内容写入文件,该方法在最后被调用,你应该总是要关闭文档。

  1.   // 关闭文档
  2.   document.close();

到目前为止,itextpdf的最基本的使用讲解完了。

下面贴一个完整的简单例子

  1.   public static void createTextPDF(String outPath, String content) {
  2.   // 创建文件及相关目录
  3.   File file = FileUtil.createNewFile(outPath, true);
  4.   if (!file.exists()) {
  5.   logger.error("创建文件失败");
  6.   return;
  7.   }
  8.   Document document = new Document();
  9.   try {
  10.   // 创建PdfWriter对象
  11.   PdfWriter writer = PdfWriter.getInstance(document, new FileOutputStream(outPath));
  12.   // 设置每行的间距
  13.   writer.setInitialLeading(30);
  14.   // 设置文档属性
  15.   // 作者
  16.   document.addAuthor("feng");
  17.   // 创建日期
  18.   document.addCreationDate();
  19.   // 创建关键字
  20.   document.addKeywords("测试");
  21.   // 创建生产商,自动使用iText
  22.   document.addProducer();
  23.   // 创建程序
  24.   document.addCreator("www.ydc51.com");
  25.   // 标题
  26.   document.addTitle("测试标题");
  27.   // 主题
  28.   document.addSubject("测试PDF创建的主题");
  29.   // 打开文档
  30.   document.open();
  31.   // 方式三:使用iTextAsian.jar中的字体
  32.   BaseFont baseFont = BaseFont.createFont("STSong-Light", "UniGB-UCS2-H", BaseFont.NOT_EMBEDDED);
  33.   Font font = new Font(baseFont);
  34.   // 设置字体大小
  35.   font.setSize(13);
  36.   // 设置字体颜色
  37.   font.setColor(new BaseColor(255, 0, 0));
  38.   // 设置类型,加粗
  39.   font.setStyle(Font.BOLD);
  40.   // 设置类型,倾斜
  41.   font.setStyle(Font.ITALIC);
  42.   // 设置类型,下划线
  43.   font.setStyle(Font.UNDERLINE);
  44.   // 设置类型,可组合,倾斜+删除线
  45.   font.setStyle(Font.ITALIC | Font.STRIKETHRU);
  46.   // 设置类型,为正常
  47.   font.setStyle(Font.NORMAL);
  48.   // 块
  49.   Chunk chunk = new Chunk("下标");
  50.   // 设置字体,字体定宽
  51.   chunk.setFont(new Font(baseFont, 4));
  52.   // 设置背景颜色
  53.   chunk.setBackground(new BaseColor(0xFF, 0xFF, 0x00));
  54.   // 设置上表下标
  55.   chunk.setTextRise(-3f);
  56.   Paragraph paragraph = new Paragraph(content, font);
  57.   // 试图将一个段落放在同一页中,该方法并不是始终有效
  58.   paragraph.setKeepTogether(true);
  59.   paragraph.add(chunk);
  60.   document.add(paragraph);
  61.   // low level
  62.   PdfContentByte cb = writer.getDirectContent();
  63.   cb.fill();
  64.   cb.sanityCheck();
  65.   } catch (Exception e) {
  66.   logger.error("", e);
  67.   } finally {
  68.   // 关闭文档
  69.   document.close();
  70.   }
  71.   }

效果图:

itextpdf还有很多高级功能的使用。

标签:readonly,itextSharp,static,new,PDF,NET,document,public,Rectangle
来源: https://www.cnblogs.com/sexintercourse/p/16276434.html