一步一步 ITextSharp Anchor Image Chapter Section使用

上一篇对块，语句、段落、列表进行了演示，本篇将对更高级的对象Anchor、Image、Chapter、Section的使用方法进行演示。

一、Anchor

Anchor对象可以在文档内部或向外部跳转。内部跳转常见的应用就是目录，外部跳转就是跳转到指定的文件或网页。下面代码演示文档内部跳转和跳转到博客园点。

public class AnchorDemo : TestBase
    {
        protected override void WriteDocument(Document document, PdfWriter writer)
        {
            Paragraph p = new Paragraph();
            p.Add("这是一个Anchor测试演示示例：");

            Anchor anchor = new Anchor("首页",Normal);
            anchor.Name = "first";
            var anchor2 = new Anchor("第二页", Normal);
            anchor2.Reference = "#second";
            var anchor3 = new Anchor("第三页", Normal);
            anchor3.Reference = "#third";
            p.Add(anchor);
            p.Add(anchor2);
            p.Add(anchor3);

            var anchor10 = new Anchor("博客园-学无止境", Normal);
            anchor10.Reference = "http://www.cnblogs.com/LifelongLearning/";
            document.Add(p);
            document.Add(anchor10);

            document.NewPage();
            var anchor1 = new Anchor("第二页", Normal);
            anchor1.Name = "second";
            document.Add(anchor1);

            var anchor4 = new Anchor("回到首页", Normal);
            anchor4.Reference = "#first";
            document.Add(anchor4);

            document.NewPage();
            var anchor5 = new Anchor("第三页", Normal);
            anchor5.Name = "third";
            document.Add(anchor5);

            var anchor6 = new Anchor("回到首页", Normal);
            anchor6.Reference = "#first";
            document.Add(anchor6);
        }
    }

本节对演示代码进行了重构，基类代码请查看：一步一步 IText.Sharp

上面的代码演示结果如下：

Chunk也可以创建跳转链接，

Chunk.SetLocalDestination 设置本地描述名称，可以说它是当前锚点的名称

Chunk.SetLocalGoto   设置本地跳转到锚点

Chunk.SetRemoteGoto 设置远程跳转，如url

示例代码如下：

public class GoTopDemo : TestBase
    {
        protected override void WriteDocument(Document document, PdfWriter writer)
        {
            Paragraph p = new Paragraph();
            Chunk top = new Chunk("Country List", Bolditalic);
            top.SetLocalDestination("top");
            p.Add(top);
            document.Add(p);
            Chunk imdb =
              new Chunk("博客园", Bolditalic);
            imdb.SetAnchor(new Uri("http://www.cnblogs.com/"));
            p = new Paragraph("点击每页的返回首页，将返回到第一页,",Normal);
            p.Add(imdb);
            p.Add(".");
            document.Add(p);
            p = new Paragraph("This list can be found in a ");
            Chunk page1 = new Chunk("分割文档(本地文档跳转)", Normal);
            page1.SetRemoteGoto("helloworld2.pdf", 1);
            p.Add(page1);
            p.Add(".");
            document.Add(p);

            document.NewPage();
            p = new Paragraph("返回", Normal);
            top = new Chunk("首页", Normal);
            top.SetLocalGoto("top");
            p.Add(top);
            p.Add(".");
            document.Add(p);
            document.NewPage();
            p = new Paragraph("返回", Normal);
            top = new Chunk("首页", Normal);
            top.SetLocalGoto("top");
            p.Add(top);
            p.Add(".");
            document.Add(p);

            document.NewPage();
            p = new Paragraph("返回", Normal);
            top = new Chunk("首页", Normal);
            top.SetLocalGoto("top");
            p.Add(top);
            p.Add(".");
            document.Add(p);

            document.NewPage();
            p = new Paragraph("返回");
            top = new Chunk("首页");
            top.SetLocalGoto("top");
            p.Add(top);
            p.Add(".");
            document.Add(p);

            document.NewPage();
            p = new Paragraph("返回");
            top = new Chunk("首页");
            top.SetLocalGoto("top");
            p.Add(top);
            p.Add(".");
            document.Add(p);
        }
    }

二、Chapter与Section

Chapter和Section用来创建书签和文档结构非常有用。同时使用PdfOutline也可以创建书签，默认情况下，生成章节和分区使用的是数字标识，如下所示：

代码如下：

public class ChapterDemo2 : TestBase
    {
        protected override void WriteDocument(Document document, PdfWriter writer)
        {
            string[] contries = new string[] { "美国", "英国", "中国", "朝鲜", "日本" };

            Paragraph title = null;
            Chapter chapter = null;
            Section section = null;
            Section subsection = null;
            title = new Paragraph("标题一", Normal);
            chapter = new Chapter(title, 1);
            title = new Paragraph("区域一", Bolditalic);
            section = chapter.AddSection(title, 2);
            title = new Paragraph("子区域一", Normal);
            subsection = section.AddSection(title);

            subsection.IndentationLeft = (20);
            subsection.NumberDepth = (1);
            subsection.Add(new Paragraph("时间: " + 12, Normal));
            subsection.Add(new Paragraph("导演(s):", Normal));
            subsection.Add(GetDirectorList(contries));
            subsection.Add(new Paragraph("国家:", Normal));
            subsection.Add(GetDirectorList(contries));

            document.Add(chapter);
        }

        private List GetDirectorList(string[] list)
        {
            List result = new List();
            foreach (var c in list)
            {
                result.Add(new ListItem(c, Normal));
            }


            return result;
        }
    }

三、Image

在ITextSharp中使用Image.getInstance方法创建Image对象，支持的文件类型包括：

Jpeg, PngImage, GifImage,
TiffImage

itextsharp会自动调整图文的内容，以让页面显示更多的内容，如果要禁用这种情况，就要使用如下方法：

PdfWriter.GetInstance(document,new FileStream(filename)).StrictImageSequence = true;

强制使用添加顺序。

图像有对象方式，有如下几种：左对齐、右对齐、居中对齐、自动调整，

图像的位置可以通过，上下左右来设置控制，同时可以通过：ScalePercent，ScaleToFit，

ScaleAbsolute，scaleAbsoluteWidth，scaleAbsoluteHeight调整图像显示大小，对于布局的控制非常方便。

备注：如果同一个图像创建多次并都添加到文档中，文档的大小就增长很快，如果一个图像要在多个地方使用，只要生成一个Image对象，在添加到文档前，设置其属性就可以了，没有必要创建多份。

图像还支持旋转：

RotationDegrees，这个是设置旋转的角度，可以设置正负数。

演示示例效果如下：

代码如下：

public class ImageDemo : TestBase
    {
        protected override void WriteDocument(Document document, PdfWriter writer)
        {
            writer.StrictImageSequence = true;
            document.Add(new Paragraph("左对齐:", Normal));
            Image image = CreateImageObject();
            image.Alignment = Image.ALIGN_LEFT;
            image.ScalePercent(30);
            document.Add(image);

            document.Add(new Paragraph("右对齐:", Normal));
            //image = CreateImageObject();
            image.ScalePercent(30);
            image.Alignment = Image.ALIGN_RIGHT;
            document.Add(image);

            document.Add(new Paragraph("居中对齐:", Normal));
            //image = CreateImageObject();
            image.Alignment = Image.ALIGN_MIDDLE;
            image.ScaleToFit(150,300);
            document.Add(image);

            document.Add(new Paragraph("适合页面对齐:", Normal));
            //image = CreateImageObject();
            image.Alignment = Image.ALIGN_JUSTIFIED_ALL;
            image.ScalePercent(30);
            document.Add(image);
            document.NewPage();
            var p = new Paragraph("旋转一:", Normal);
            p.Add(Chunk.NEWLINE);

            p.Add(Chunk.NEWLINE);
            p.Add(Chunk.NEWLINE);
            p.Add(Chunk.NEWLINE);
            p.Add(Chunk.NEWLINE);
            p.Add(Chunk.NEWLINE);
            p.Add(Chunk.NEWLINE);
            p.Add(Chunk.NEWLINE);
            p.Add(Chunk.NEWLINE);
            p.Add(Chunk.NEWLINE);
            p.Add(Chunk.NEWLINE);
            p.Add(Chunk.NEWLINE);
            p.Add(Chunk.NEWLINE);
            image.Alignment = Image.ALIGN_JUSTIFIED_ALL;
            image.ScalePercent(30);
            image.RotationDegrees = 30;
            p.Add(new Chunk(image, 0, -30));
            document.Add(p);

            p = new Paragraph("旋转二:", Normal);
            p.Add(Chunk.NEWLINE);
            p.Add(Chunk.NEWLINE);
            p.Add(Chunk.NEWLINE);
            p.Add(Chunk.NEWLINE);
            p.Add(Chunk.NEWLINE);
            p.Add(Chunk.NEWLINE);
            p.Add(Chunk.NEWLINE);
            p.Add(Chunk.NEWLINE);
            p.Add(Chunk.NEWLINE);
            p.Add(Chunk.NEWLINE);
            p.Add(Chunk.NEWLINE);
            p.Add(Chunk.NEWLINE);
            p.Add(Chunk.NEWLINE);
            image.Alignment = Image.ALIGN_JUSTIFIED_ALL;
            image.ScalePercent(30);
            image.RotationDegrees = -30;
            p.Add(new Chunk(image, 0, -15));
            document.Add(p);
        }

        private Image CreateImageObject()
        {
            return Image.GetInstance(@"C:\Users\Public\Pictures\Sample Pictures\123.jpg");
        }
    }