一步一步 IText.Sharp Chunk Phrase Paragraph List使用

上面两篇介绍了PDF文档的创建和中文支持设置方法，下面对文档经常使用的对象时行介绍：

块(Chunk)、短句(Phrase)、段落(Paragraph)、列表(List)

文档中的对象UML图，如下：

一、块（Chunk）

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

它有字体、大小、颜色、粗体，背景色、下划线，删除线等属性。

示例代码：

static  void RegisterFont()
        {
            BaseFont.AddToResourceSearch("iTextAsian.dll");
            BaseFont.AddToResourceSearch("iTextAsianCmaps.dll");
            FontFactory.Register(Environment.GetFolderPath(Environment.SpecialFolder.System) +
                                 @"\..\Fonts\STSONG.ttf");
            FontFactory.Register(Environment.GetFolderPath(Environment.SpecialFolder.System) +
                                 @"\..\Fonts\simhei.ttf");
            FontFactory.Register(Environment.GetFolderPath(Environment.SpecialFolder.System) +
                                 @"\..\Fonts\simsun.ttc");
        }

        static void Main(string[] args)
        {
            RegisterFont();
            Document document = new Document();
            PdfWriter.GetInstance(document, new FileStream(string.Format("{0}helloworld.pdf",
                AppDomain.CurrentDomain.BaseDirectory), FileMode.OpenOrCreate))
              .InitialLeading = 16;
            document.Open();

            string[] contries = new string[]{"美国","英甲","中国","朝鲜","日本"};
            for (int index = 1; index <= contries.Length;index++ )
            {
                var contry = contries[index-1];
                document.Add(new Chunk(contry,FontFactory.GetFont("华文宋体", BaseFont.IDENTITY_H, 16)));
                document.Add(new Chunk(" "));
                Font font = new Font(
                  Font.FontFamily.HELVETICA, 6, Font.BOLD, BaseColor.WHITE);
                Chunk id = new Chunk(index.ToString(), font);
                id.SetBackground(BaseColor.BLACK, 1f, 0.5f, 1f, 1.5f);
                id.SetTextRise(6);
                document.Add(id);
                document.Add(Chunk.NEWLINE);
            }

            document.Close();
        }

执行结果如下：

在上面的代码中，使用设置行距和使用一个特殊的块：Chunk.NEWLINE

作为示例，可以不设置行距或设置为0，当为零时，多行就会显示到一行上面（重叠）

当设置为0 时，根本就看不清楚。

在创建对象时，如果没有指定字体及其大小，默认情况下是Helvetica，12pt,并且这个设置是没有办法修改的。只有在创建对象时显示指定字体。

SetBackground用于设置块的背景色，SetTextRise是设置上标，其中参数表示，离开基线的距离，如果设置负数就表示设置下标。

二、语句（Phrase)

短句（Phrase）是一系列以特定间距（两行之间的距离）作为参数的块，一个短句有一个主字体，但短句中的一些块具有不同于主字体的字体，你有更多的选择去创建短句。

简单来说，就是由多个同一行间距块组成。

演示代码，如下：

static void Main(string[] args)
        {
            RegisterFont();
            BOLD_UNDERLINED = FontFactory.GetFont("华文宋体", BaseFont.IDENTITY_H, 12, Font.BOLD | Font.UNDERLINE);
            NORMAL = FontFactory.GetFont("华文宋体", BaseFont.IDENTITY_H, 12);
            Document document = new Document();
            PdfWriter.GetInstance(document, new FileStream(string.Format("{0}helloworld.pdf",
                AppDomain.CurrentDomain.BaseDirectory), FileMode.OpenOrCreate))
              .InitialLeading = 30;
            document.Open();

            string[] contries = new string[] { "美国", "英甲", "中国", "朝鲜", "日本" };
            for (int index = 1; index <= contries.Length; index++)
            {
                var contry = contries[index - 1];
                document.Add(CreateDirectorPhrase(contry));
                document.Add(Chunk.NEWLINE);
            }

            document.Close();
        }

        public static Font BOLD_UNDERLINED = FontFactory.GetFont("华文宋体", BaseFont.IDENTITY_H, 12, Font.BOLD | Font.UNDERLINE);
        public static Font NORMAL = FontFactory.GetFont("华文宋体", BaseFont.IDENTITY_H, 12);
        public static Phrase CreateDirectorPhrase(string str)
        {
            Phrase director = new Phrase();
            director.Add(new Chunk(str, BOLD_UNDERLINED));
            director.Add(new Chunk(",", BOLD_UNDERLINED));
            director.Add(new Chunk(" ", NORMAL));
            director.Add(new Chunk(str, NORMAL));
            return director;
        }

执行结果：

默认情况下，行间距是1.5倍字体大小，可以不用设置行间距，就比较好的显示文档。

三、段落(Paragraph)

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

说明：一个段落有一个且仅有一个间距，如果你添加了一个不同字体的短句或块，原来的间距仍然有效，你可以通过SetLeading来改变间距，但是段落中所有内容将使用新的中的间距。

更改分割符

通常，当文本不能放在一行时，文本将被分割成不同的部分，iText首先会查找分割符，如果没有找到，文本将在行尾被截断。有一些预定的分割符如“ ”空格和“-”连字符，但是你可以使用setSplitCharacter方法来覆盖这些默认值。

以使用IndentationLeft和IndentationRight，FirstLineIndent属性设置缩排；

演示代码如下：

public static Font BOLD_UNDERLINED = FontFactory.GetFont("华文宋体", BaseFont.IDENTITY_H, 12, Font.BOLD | Font.UNDERLINE);
        public static Font NORMAL = FontFactory.GetFont("华文宋体", BaseFont.IDENTITY_H, 12);
        static Font BOLDITALIC = FontFactory.GetFont("华文宋体", BaseFont.IDENTITY_H, 12, Font.BOLD | Font.ITALIC);
        public static Phrase CreateDirectorPhrase(string str)
        {
            Phrase director = new Phrase();
            //director.Add(new Chunk(str, BOLD_UNDERLINED));
            //director.Add(new Chunk(",", BOLD_UNDERLINED));
            //director.Add(new Chunk(" ", NORMAL));
            director.Add(new Chunk(str, NORMAL));
            return director;
        }

        static void Main(string[] args)
        {
            RegisterFont();
            BOLD_UNDERLINED = FontFactory.GetFont("华文宋体", BaseFont.IDENTITY_H, 12, Font.BOLD | Font.UNDERLINE);
            NORMAL = FontFactory.GetFont("华文宋体", BaseFont.IDENTITY_H, 12);
            BOLDITALIC = FontFactory.GetFont("华文宋体", BaseFont.IDENTITY_H, 12, Font.BOLD | Font.ITALIC);
            Document document = new Document();
            PdfWriter.GetInstance(document, new FileStream(string.Format("{0}helloworld.pdf",
                AppDomain.CurrentDomain.BaseDirectory), FileMode.OpenOrCreate))
              .InitialLeading = 30;
            document.Open();

            string[] contries = new string[] { "美国", "英甲", "中国", "朝鲜", "日本" };
            List<Movie> list = new List<Movie>() { new Movie() { Countries = new List<string>() { "中国", "美国" }, Directors = new List<string>() { "张三", "李四" }, Duration = "120", OriginalTitle = "电影一", Year = "2010" }, new Movie() { Countries = new List<string>() { "英国", "美国" }, Directors = new List<string>() { "张三", "王五" }, Duration = "80", OriginalTitle = "电影二", Year = "2011" }, new Movie() { Countries = new List<string>() { "英国", "中国" }, Directors = new List<string>() { "王五", "张三" }, Duration = "200", OriginalTitle = "2012", Year = "2009" }, new Movie() { Countries = new List<string>() { "日本", "中国" }, Directors = new List<string>() { "王五", "李四" }, Duration = "180", OriginalTitle = "电影四", Year = "2009" } };
            for (int index = 1; index <= list.Count; index++)
            {
                var contry = list[index - 1];
                document.Add(CreateMovieInformation(contry));
                document.Add(Chunk.NEWLINE);
            }

            document.Close();
        }

        public static Paragraph CreateYearAndDuration(Movie movie)
        {
            Paragraph info = new Paragraph();
            info.Font = (NORMAL);
            info.Add(new Chunk("年代: ", BOLDITALIC));
            info.Add(new Chunk(movie.Year,
              NORMAL));
            info.Add(new Chunk("持续时间: ", BOLDITALIC));
            info.Add(new Chunk(movie.Duration,
              NORMAL));
            info.Add(new Chunk(" 分钟", NORMAL));
            return info;
        }
        public static Paragraph CreateMovieInformation(Movie movie)
        {
            Paragraph p = new Paragraph();
            p.Font = (NORMAL);
            p.Add(new Phrase("标题: ", BOLDITALIC));
            p.Add(
              movie.OriginalTitle);
            p.Add(" ");
            if (movie.OriginalTitle != null)
            {
                p.Add(new Phrase(
                  "正式标题: ", BOLDITALIC));
                p.Add(movie.OriginalTitle);
                p.Add(" ");
            }
            p.Add(new Phrase("国家: ", BOLDITALIC));
            foreach (var country in movie.Countries)
            {
                p.Add(
                  CreateDirectorPhrase(country));
                p.Add(" ");
            }
            p.Add(new Phrase("导演: ", BOLDITALIC));
            foreach (var director in movie.Directors)
            {
                p.Add(
                     CreateDirectorPhrase(director));
                p.Add(" ");
            }
            p.Add(CreateYearAndDuration(movie));
            return p;
        }

执行结果：

默认情况下，文本的对齐方式为左对齐，可以通过属性“Alignment”进行设置，

RIGHT. Element.ALIGN_JUSTIFIED_ALL 和Element.ALIGN_JUSTIFIED是很相似的，唯一的区别是前一种是占满整行，如下图

首行缩进（FirstLineIndent），左边缩进（tIndentationLeft），右边缩进（IndentationRight）：

演示关键代码如下：

var p = new Paragraph("这是一个缩进演示：段落是一系列块和（或）短句。同短句一样，段落有确定的间距。用户还可以指定缩排；在边和（或）右边保留一定空白，段落可以左对齐、右对齐和居中对齐。添加到文档中的每一个段落将自动另起一行。说明：一个段落有一个且仅有一个间距，如果你添加了一个不同字体的短句或块，原来的间距仍然有效，你可以通过SetLeading来改变间距，但是段落中所有内容将使用新的中的间距。更改分割符 通常，当文本不能放在一行时，文本将被分割成不同的部分，iText首先会查找分割符，如果没有找到，文本将在行尾被截断。有一些预定的分割符如“ ”空格和“-”连字符，但是你可以使用setSplitCharacter方法来覆盖这些默认值。",NORMAL);
            p.Alignment = Element.ALIGN_JUSTIFIED;
            p.IndentationLeft = 12;
            p.IndentationRight = 24;
            p.FirstLineIndent = 24;
            document.Add(p);

            p = new Paragraph("段落是一系列块和（或）短句。同短句一样，段落有确定的间距。用户还可以指定缩排；在边和（或）右边保留一定空白，段落可以左对齐、右对齐和居中对齐。添加到文档中的每一个段落将自动另起一行。说明：一个段落有一个且仅有一个间距，如果你添加了一个不同字体的短句或块，原来的间距仍然有效，你可以通过SetLeading来改变间距，但是段落中所有内容将使用新的中的间距。更改分割符 通常，当文本不能放在一行时，文本将被分割成不同的部分，iText首先会查找分割符，如果没有找到，文本将在行尾被截断。有一些预定的分割符如“ ”空格和“-”连字符，但是你可以使用setSplitCharacter方法来覆盖这些默认值。", NORMAL);
            p.Alignment = Element.ALIGN_JUSTIFIED;
            document.Add(p);

段落间隔：

段落间隔使用如下两个属性：

SpacingAfter

SpacingBefore

进行设置。

文档在长度超过一行显示，使用分割符来进行断句换行，默认的分割符是空格和连字符，通过继承类“SplitCharacter”，来实现自定义的分割符。

四、列表(List)

列表就是一个有顺序的段落对象集合。

演示代码：

static void Main(string[] args)
        {
            RegisterFont();
            BOLD_UNDERLINED = FontFactory.GetFont("华文宋体", BaseFont.IDENTITY_H, 12, Font.BOLD | Font.UNDERLINE);
            NORMAL = FontFactory.GetFont("华文宋体", BaseFont.IDENTITY_H, 12);
            BOLDITALIC = FontFactory.GetFont("华文宋体", BaseFont.IDENTITY_H, 12, Font.BOLD | Font.ITALIC);
            Document document = new Document();
            PdfWriter.GetInstance(document, new FileStream(string.Format("{0}helloworld.pdf",
                AppDomain.CurrentDomain.BaseDirectory), FileMode.OpenOrCreate))
              .InitialLeading = 30;
            document.Open();

            string[] contries = new string[] { "美国", "英甲", "中国", "朝鲜", "日本" };
            document.Add(new Chunk("默认列表演示1：", NORMAL));
            document.Add(Chunk.NEWLINE);
            List list = new List();
            for (int index = 1; index <= contries.Length; index++)
            {
                var contry = contries[index - 1];
                list.Add(new ListItem(contry, NORMAL));
            }
            document.Add(list);
            document.Add(Chunk.NEWLINE);
            document.Add(new Chunk("不显示数字演示2：", NORMAL));
            document.Add(Chunk.NEWLINE);

            list = new List(false);
            for (int index = 1; index <= contries.Length; index++)
            {
                var contry = contries[index - 1];
                list.Add(new ListItem(contry, NORMAL));
            }
            document.Add(list);
            document.Add(Chunk.NEWLINE);

            document.Add(new Chunk("使用#作为列表符号3：", NORMAL));
            document.Add(Chunk.NEWLINE);
            list = new List();
            list.SetListSymbol("#");
            for (int index = 1; index <= contries.Length; index++)
            {
                var contry = contries[index - 1];
                list.Add(new ListItem(contry, NORMAL));
            }
            document.Add(list);

            document.Add(Chunk.NEWLINE);
            document.Add(new Chunk("显示数字演示4：", NORMAL));
            document.Add(Chunk.NEWLINE);

            list = new List(true);
            for (int index = 1; index <= contries.Length; index++)
            {
                var contry = contries[index - 1];
                list.Add(new ListItem(contry, NORMAL));
            }
            document.Add(list);

            document.Add(Chunk.NEWLINE);
            document.Add(new Chunk("RomanList演示5：", NORMAL));
            document.Add(Chunk.NEWLINE);

            var list1 = new RomanList();
            for (int index = 1; index <= contries.Length; index++)
            {
                var contry = contries[index - 1];
                list1.Add(new ListItem(contry, NORMAL));
            }
            document.Add(list1);

            document.Add(Chunk.NEWLINE);
            document.Add(new Chunk("GreekList演示6：", NORMAL));
            document.Add(Chunk.NEWLINE);

            var list2 = new GreekList();
            for (int index = 1; index <= contries.Length; index++)
            {
                var contry = contries[index - 1];
                list2.Add(new ListItem(contry, NORMAL));
            }
            document.Add(list2);

            document.Add(Chunk.NEWLINE);
            document.Add(new Chunk("ZapfDingbatsNumberList演示7：", NORMAL));
            document.Add(Chunk.NEWLINE);

            var list3 = new ZapfDingbatsNumberList(10);
            for (int index = 1; index <= contries.Length; index++)
            {
                var contry = contries[index - 1];
                list3.Add(new ListItem(contry, NORMAL));
            }
            document.Add(list3);

            document.Add(Chunk.NEWLINE);
            document.Add(new Chunk("ZapfDingbatsList演示8：", NORMAL));
            document.Add(Chunk.NEWLINE);

            var list4 = new ZapfDingbatsList(10);
            for (int index = 1; index <= contries.Length; index++)
            {
                var contry = contries[index - 1];
                list4.Add(new ListItem(contry, NORMAL));
            }
            document.Add(list4);

            document.Close();
        }

执行结果：

这个列表，还有一些扩展列表，如上面演示的5-7。