当前位置：首页 > news >正文

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

news 来源：原创 2024/5/20 22:59:57

提到打印，恐怕对于很多人都不会陌生，无论是开发者，还是非计算机专业的人员都会接触到打印。对于项目开发中使用到打印的地方会非常多，在.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()方法：打开文档对象。

public virtual void Open(){  
    if (!this.close)  
    {    
        this.open = true;  
    }  
    foreach (IDocListener listener in this.listeners)  
    {
        listener.SetPageSize(this.pageSize);
        listener.SetMargins(this.marginLeft, this.marginRight, this.marginTop, this.marginBottom);
        listener.Open();  
    }
}

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

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

public override bool Add(IElement o)
{
    if(o is List)
    {
        List element = (List) o;
        element.IndentationLeft += this.indentationLeft;
        element.IndentationRight = this.indentationRight;
        base.Add(element);
        return true;
    }
    if(o is Image)
    {
        base.AddSpecial((Image) o);
        return true;
    }
    if(o is Paragraph)
    {
        base.Add(o);
        IList < Chunk > chunks = this.Chunks;
        if(chunks.Count > 0)
        {
            Chunk chunk = chunks[chunks.Count - 1];
            base.Add(new Chunk("\n", chunk.Font));
        }
        else
        {
            base.Add(Chunk.NEWLINE);
        }
        return true;
    }
    base.Add(o);
    return true;
}
public interface IElement
{
    bool IsContent();
    bool IsNestable();
    bool Process(IElementListener listener);
    string ToString(); // Properties  
    IList < Chunk > Chunks
    {
        get;
    }
    int Type
    {
        get;
    }
}

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

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

public static Image GetInstance(Image image)
{
    if(image == null)
    {
        return null;
    }
    return(Image) image.GetType().GetConstructor(BindingFlags.Public | BindingFlags.Instance, null, new Type[]
    {
        typeof(Image)
    }, null).Invoke(new object[]
    {
        image
    });
}
public static Image GetInstance(byte[] imgb)
{
    int num = imgb[0];
    int num2 = imgb[1];
    int num3 = imgb[2];
    int num4 = imgb[3];
    if(((num == 0x47) && (num2 == 0x49)) && (num3 == 70))
    {
        GifImage image = new GifImage(imgb);
        return image.GetImage(1);
    }
    if((num == 0xff) && (num2 == 0xd8))
    {
        return new Jpeg(imgb);
    }
    if(((num == 0) && (num2 == 0)) && ((num3 == 0) && (num4 == 12)))
    {
        return new Jpeg2000(imgb);
    }
    if(((num == 0xff) && (num2 == 0x4f)) && ((num3 == 0xff) && (num4 == 0x51)))
    {
        return new Jpeg2000(imgb);
    }
    if(((num == PngImage.PNGID[0]) && (num2 == PngImage.PNGID[1])) && ((num3 == PngImage.PNGID[2]) && (num4 == PngImage.PNGID[3])))
    {
        return PngImage.GetImage(imgb);
    }
    if((num == 0xd7) && (num2 == 0xcd))
    {
        return new ImgWMF(imgb);
    }
    if((num == 0x42) && (num2 == 0x4d))
    {
        return BmpImage.GetImage(imgb);
    }
    if((((num == 0x4d) && (num2 == 0x4d)) && ((num3 == 0) && (num4 == 0x2a))) || (((num == 0x49) && (num2 == 0x49)) && ((num3 == 0x2a) && (num4 == 0))))
    {
        RandomAccessFileOrArray s = null;
        try
        {
            s = new RandomAccessFileOrArray(imgb);
            Image tiffImage = TiffImage.GetTiffImage(s, 1);
            if(tiffImage.OriginalData == null)
            {
                tiffImage.OriginalData = imgb;
            }
            return tiffImage;
        }
        finally
        {
            if(s != null)
            {
                s.Close();
            }
        }
    }
    throw new IOException(MessageLocalization.GetComposedMessage("the.byte.array.is.not.a.recognized.imageformat"));
}

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

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

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

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

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

public override bool Process(IElementListener listener)
{
    try
    {
        bool flag = (this.reference != null) && this.reference.StartsWith("#");
        bool flag2 = true;
        foreach(Chunk chunk in this.Chunks)
        {
            if(((this.name != null) && flag2) && !chunk.IsEmpty())
            {
                chunk.SetLocalDestination(this.name);
                flag2 = false;
            }
            if(flag)
            {
                chunk.SetLocalGoto(this.reference.Substring(1));
            }
            else if(this.reference != null)
            {
                chunk.SetAnchor(this.reference);
            }
            listener.Add(chunk);
        }
        return true;
    }
    catch(DocumentException)
    {
        return false;
    }
}

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

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

public class PageSize
{ // Fields  
    public static readonly Rectangle _11X17;
    public static readonly Rectangle A0;
    public static readonly Rectangle A1;
    public static readonly Rectangle A10;
    public static readonly Rectangle A2;
    public static readonly Rectangle A3;
    public static readonly Rectangle A4;
    public static readonly Rectangle A4_LANDSCAPE;
    public static readonly Rectangle A5;
    public static readonly Rectangle A6;
    public static readonly Rectangle A7;
    public static readonly Rectangle A8;
    public static readonly Rectangle A9;
    public static readonly Rectangle ARCH_A;
    public static readonly Rectangle ARCH_B;
    public static readonly Rectangle ARCH_C;
    public static readonly Rectangle ARCH_D;
    public static readonly Rectangle ARCH_E;
    public static readonly Rectangle B0;
    public static readonly Rectangle B1;
    public static readonly Rectangle B10;
    public static readonly Rectangle B2;
    public static readonly Rectangle B3;
    public static readonly Rectangle B4;
    public static readonly Rectangle B5;
    public static readonly Rectangle B6;
    public static readonly Rectangle B7;
    public static readonly Rectangle B8;
    public static readonly Rectangle B9;
    public static readonly Rectangle CROWN_OCTAVO;
    public static readonly Rectangle CROWN_QUARTO;
    public static readonly Rectangle DEMY_OCTAVO;
    public static readonly Rectangle DEMY_QUARTO;
    public static readonly Rectangle EXECUTIVE;
    public static readonly Rectangle FLSA;
    public static readonly Rectangle FLSE;
    public static readonly Rectangle HALFLETTER;
    public static readonly Rectangle ID_1;
    public static readonly Rectangle ID_2;
    public static readonly Rectangle ID_3;
    public static readonly Rectangle LARGE_CROWN_OCTAVO;
    public static readonly Rectangle LARGE_CROWN_QUARTO;
    public static readonly Rectangle LEDGER;
    public static readonly Rectangle LEGAL;
    public static readonly Rectangle LEGAL_LANDSCAPE;
    public static readonly Rectangle LETTER;
    public static readonly Rectangle LETTER_LANDSCAPE;
    public static readonly Rectangle NOTE;
    public static readonly Rectangle PENGUIN_LARGE_PAPERBACK;
    public static readonly Rectangle PENGUIN_SMALL_PAPERBACK;
    public static readonly Rectangle POSTCARD;
    public static readonly Rectangle ROYAL_OCTAVO;
    public static readonly Rectangle ROYAL_QUARTO;
    public static readonly Rectangle SMALL_PAPERBACK;
    public static readonly Rectangle TABLOID;
    // Methods  
    static PageSize();
    public PageSize();
    public static Rectangle GetRectangle(string name);
}

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

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

三.itextSharp组件实例：

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

/// <summary>    /// 字体    /// </summary>    
private Font _font;
/// <summary>    /// 文档大小    /// </summary>    
private Rectangle _rect;
/// <summary>    /// 文档对象    /// </summary>    
private readonly Document _document;
/// <summary>    /// 基础字体    /// </summary>    
private BaseFont _basefont;
/// <summary>    /// 构造函数    /// </summary>    
    public PDFOperation()
    {
        _rect = PageSize.A4;
        _document = new Document(_rect);
    }
    /// <summary>    /// 构造函数    /// </summary>    
    /// <param name="type">页面大小(如"A4")</param>    
    public PDFOperation(string type)
    {
        if(string.IsNullOrEmpty(type))
        {
            throw new ArgumentNullException(type);
        }
        SetPageSize(type);
        _document = new Document(_rect);
    }
    /// <summary>    /// 构造函数    /// </summary>    
    /// <param name="type">页面大小(如"A4")</param>    
    /// <param name="marginLeft">内容距左边框距离</param>    
    /// <param name="marginRight">内容距右边框距离</param>    
    /// <param name="marginTop">内容距上边框距离</param>    
    /// <param name="marginBottom">内容距下边框距离</param>    
    public PDFOperation(string type, float marginLeft, float marginRight, float marginTop, float marginBottom)
    {
        if(string.IsNullOrEmpty(type))
        {
            throw new ArgumentNullException(type);
        }
        SetPageSize(type);
        _document = new Document(_rect, marginLeft, marginRight, marginTop, marginBottom);
    }
    /// <summary>    /// 设置字体    /// </summary>    
public void SetBaseFont(string path)
    {
        if(string.IsNullOrEmpty(path))
        {
            throw new ArgumentNullException(path);
        }
        _basefont = BaseFont.CreateFont(path, BaseFont.IDENTITY_H, BaseFont.NOT_EMBEDDED);
    }
    /// <summary>    /// 设置字体    /// </summary>    
    /// <param name="size">字体大小</param>    
    public void SetFont(float size)
    {
        _font = new Font(_basefont, size);
    }
    /// <summary>    /// 设置页面大小    /// </summary>    
    /// <param name="type">页面大小(如"A4")</param>    
    public void SetPageSize(string type)
    {
        if(string.IsNullOrEmpty(type))
        {
            throw new ArgumentNullException(type);
        }
        switch(type.Trim())
        {
            //枚举需要的文档纸张大小        
            case "A3":
                _rect = PageSize.A3;
                break;
            case "A4":
                _rect = PageSize.A4;
                break;
            case "A8":
                _rect = PageSize.A8;
                break;
        }
    }
    /// <summary>    /// 实例化文档    /// </summary>    
    /// <param name="os">文档相关信息（如路径，打开方式等）</param>    
    public void GetInstance(Stream os)
    {
        if(os == null)
        {
            throw new ArgumentNullException("os");
        }
        PdfWriter.GetInstance(_document, os);
    }
    /// <summary>    /// 打开文档对象    /// </summary>    
    /// <param name="os">文档相关信息（如路径，打开方式等）</param>    
    public void Open(Stream os)
    {
        if(os == null)
        {
            throw new ArgumentNullException("os");
        }
        GetInstance(os);
        _document.Open();
    }
    /// <summary>    /// 关闭打开的文档    /// </summary>    
    public void Close()
    {
        _document.Close();
    }
    /// <summary>    /// 添加段落    /// </summary>    
    /// <param name="content">内容</param>    
    /// <param name="fontsize">字体大小</param>    
    public void AddParagraph(string content, float fontsize)
    {
        SetFont(fontsize);
        var pra = new Paragraph(content, _font);
        _document.Add(pra);
    }
    /// <summary>    /// 添加段落    /// </summary>    
    /// <param name="content">内容</param>    
    /// <param name="fontsize">字体大小</param>    
    /// <param name="alignment">对齐方式（1为居中，0为居左，2为居右）</param>    
    /// <param name="spacingAfter">段后空行数（0为默认值）</param>    
    /// <param name="spacingBefore">段前空行数（0为默认值）</param>    
    /// <param name="multipliedLeading">行间距（0为默认值）</param>    
    public void AddParagraph(string content, float fontsize, int alignment, float spacingAfter, float spacingBefore, float multipliedLeading)
    {
        SetFont(fontsize);
        var pra = new Paragraph(content, _font)
        {
            Alignment = alignment
        };
        if(spacingAfter != 0)
        {
            pra.SpacingAfter = spacingAfter;
        }
        if(spacingBefore != 0)
        {
            pra.SpacingBefore = spacingBefore;
        }
        if(multipliedLeading != 0)
        {
            pra.MultipliedLeading = multipliedLeading;
        }
        _document.Add(pra);
    }
    /// <summary>    /// 添加图片    /// </summary>    
    /// <param name="path">图片路径</param>    
    /// <param name="alignment">对齐方式（1为居中，0为居左，2为居右）</param>    
    /// <param name="newWidth">图片宽（0为默认值，如果宽度大于页宽将按比率缩放）</param>    
    /// <param name="newHeight">图片高</param>    
    public void AddImage(string path, int alignment, float newWidth, float newHeight)
    {
        if(string.IsNullOrEmpty(path))
        {
            throw new ArgumentNullException(path);
        }
        var img = Image.GetInstance(path);
        img.Alignment = alignment;
        // ReSharper disable once CompareOfFloatsByEqualityOperator      
        if(newWidth != 0)
        {
            img.ScaleAbsolute(newWidth, newHeight);
        }
        else
        {
            if(img.Width > PageSize.A4.Width)
            {
                img.ScaleAbsolute(_rect.Width, img.Width * img.Height / _rect.Height);
            }
        }
        _document.Add(img);
    }
    /// <summary>    /// 添加链接    /// </summary>    
    /// <param name="content">链接文字</param>    
    /// <param name="fontSize">字体大小</param>    
    /// <param name="reference">链接地址</param>    
    public void AddAnchorReference(string content, float fontSize, string reference)
    {
        if(string.IsNullOrEmpty(content))
        {
            throw new ArgumentNullException(content);
        }
        SetFont(fontSize);
        var auc = new Anchor(content, _font)
        {
            Reference = reference
        };
        _document.Add(auc);
    }
    /// <summary>    /// 添加链接点    /// </summary>    
    /// <param name="content">链接文字</param>    
    /// <param name="fontSize">字体大小</param>    
    /// <param name="name">链接点名</param>    
public void AddAnchorName(string content, float fontSize, string name)
{
    if(string.IsNullOrEmpty(content))
    {
        throw new ArgumentNullException(content);
    }
    SetFont(fontSize);
    var auc = new Anchor(content, _font)
    {
        Name = name
    };
    _document.Add(auc);
}

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

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

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

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

一共有三个构造方法

public Document();
public Document(Rectangle pageSize);
public Document(Rectangle pageSize,int marginLeft,int marginRight,int marginTop,int marginBottom);

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

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

// 设置大小
Rectangle pageSize = new Rectangle(300, 500);
// 设置背景颜色
pageSize.setBackgroundColor(new BaseColor(0xFF, 0xFF, 0xDE));
// 设置边框颜色
pageSize.setBorderColor(new BaseColor(0xFF, 0xFF, 0xDE));
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，常见用法如下：

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

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

我们还可以设置行间距

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

三、打开Document

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

// 作者
document.addAuthor("feng");
// 创建日期
document.addCreationDate();
// 创建关键字
document.addKeywords("测试");
// 创建生产商，自动使用iText
document.addProducer();
// 创建程序
document.addCreator("www.ydc51.com");
// 标题
document.addTitle("测试标题");
// 主题
document.addSubject("测试PDF创建的主题");

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

然后打开文档就一句代码

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

四、添加内容

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

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

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

2、使用自己的资源字体

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

3、使用iTextAsian.jar中的字体

// 方式三：使用iTextAsian.jar中的字体
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

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

Font font = new Font(baseFont);
// 设置字体大小
font.setSize(13);
// 设置字体颜色
font.setColor(new BaseColor(255, 0, 0));
// 设置类型，为正常
font.setStyle(Font.NORMAL);
// 设置类型，加粗
font.setStyle(Font.BOLD);
// 设置类型，倾斜
font.setStyle(Font.ITALIC);
// 设置类型，下划线
font.setStyle(Font.UNDERLINE);
// 设置类型，可组合，倾斜+删除线
font.setStyle(Font.ITALIC | Font.STRIKETHRU);

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

添加内容

Paragraph paragraph = new Paragraph(content, font);

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

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

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

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

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

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

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

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

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

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

document.add(paragraph);

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

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

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

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

public static void createTextPDF(String outPath, String content) {
    // 创建文件及相关目录
    File file = FileUtil.createNewFile(outPath, true);
    if (!file.exists()) {
        logger.error("创建文件失败");
        return;
    }
    Document document = new Document();
    try {
        // 创建PdfWriter对象
        PdfWriter writer = PdfWriter.getInstance(document, new FileOutputStream(outPath));
        // 设置每行的间距
        writer.setInitialLeading(30);
        // 设置文档属性
        // 作者
        document.addAuthor("feng");
        // 创建日期
        document.addCreationDate();
        // 创建关键字
        document.addKeywords("测试");
        // 创建生产商，自动使用iText
        document.addProducer();
        // 创建程序
        document.addCreator("www.ydc51.com");
        // 标题
        document.addTitle("测试标题");
        // 主题
        document.addSubject("测试PDF创建的主题");
        // 打开文档
        document.open();
        // 方式三：使用iTextAsian.jar中的字体
        BaseFont baseFont = BaseFont.createFont("STSong-Light", "UniGB-UCS2-H",    BaseFont.NOT_EMBEDDED);
        Font font = new Font(baseFont);
        // 设置字体大小
        font.setSize(13);
        // 设置字体颜色
        font.setColor(new BaseColor(255, 0, 0));
        // 设置类型，加粗
        font.setStyle(Font.BOLD);
        // 设置类型，倾斜
        font.setStyle(Font.ITALIC);
        // 设置类型，下划线
        font.setStyle(Font.UNDERLINE);
        // 设置类型，可组合，倾斜+删除线
        font.setStyle(Font.ITALIC | Font.STRIKETHRU);
        // 设置类型，为正常
        font.setStyle(Font.NORMAL);
        // 块
        Chunk chunk = new Chunk("下标");
        // 设置字体，字体定宽
        chunk.setFont(new Font(baseFont, 4));
        // 设置背景颜色
        chunk.setBackground(new BaseColor(0xFF, 0xFF, 0x00));
        // 设置上表下标
        chunk.setTextRise(-3f);
        Paragraph paragraph = new Paragraph(content, font);
        // 试图将一个段落放在同一页中，该方法并不是始终有效
        paragraph.setKeepTogether(true);
        paragraph.add(chunk);
        document.add(paragraph);
        // low level
        PdfContentByte cb = writer.getDirectContent();
        cb.fill();
        cb.sanityCheck();
    } catch (Exception e) {
        logger.error("", e);
    } finally {
        // 关闭文档
        document.close();
    }
}

效果图：