【译】在Asp.Net中操作PDF – iTextSharp列表

    在前文中，我们已经知道了如何利用iTextSharp创建PDF文档，设置字体样式和风格.本文开始讲述iTextSharp中的有序列表和无需列表.如果你还没阅读我前面的文章，那么地址是:

    在ASP.NET中创建PDF-iTextSharp起步

    在Asp.Net中操作PDF - iTextSharp - 使用字体

    在Asp.Net中操作PDF – iTextSharp -利用块，短语，段落添加文本

    在iTextSharp中列表的创建是通过iTextSharp.text.List对象实现的。列表实质上是iTextSharp.text.ListItem的集合.也就是由ListItem组成的数组.ListItem继承了Paragraph对象（而Paragraph对象继承于Phrase,Phrase又继承于Arraylist),所以生成的每一个List都会自动换行.就如同List在HTML分为<ul>和<ol>一样，iTextSharp中列表同样分为有序列表和无序列表.下面我们来直接看如何生成列表的代码:

    

string path = Server.MapPath("PDFs");
 
it.Document doc = new it.Document();
 
try
 
{
 
    PdfWriter.GetInstance(doc, new FileStream(path + "/Lists.pdf", FileMode.Create));
 
    doc.Open();
 
    it.List list = new it.List(it.List.UNORDERED);
 
    list.Add(new it.ListItem("One"));
 
    list.Add("Two");
 
    list.Add("Three");
 
    list.Add("Four");
 
    list.Add("Five");
 
    it.Paragraph paragraph = new it.Paragraph();
 
    string text = "Lists";
 
    paragraph.Add(text);
 
    doc.Add(paragraph);
 
    doc.Add(list);
 
}
 
catch (it.DocumentException dex)
 
{
 
    Response.Write(dex.Message);
 
}
 
catch (IOException ioex)
 
{
 
    Response.Write(ioex.Message);
 
}
 
finally
 
{
 
    doc.Close();
 
}

   如果你对上面代码的意思并不了解.那么为什么要用”it"引用List的确需要解释一下.正如代码所示，it作为引用某些类，因为如果你直接在ASP.Net code-behind模式下工作，你会发现visual studio在引用iTextSharp的ListItem时和也包含ListItem的System.Web.UI.WebControls发生命名空间冲突.这意味着如果仅仅是用如下代码：

ListItem li = new ListItem();

    则会报不明确引用的警告。解决方法是使用完全引用:

iTextSharp.text.ListItem li = new iTextSharp.text.ListItem();

   但是使用完全引用又臭又长，所以这里使用了简洁引用:

using it = iTextSharp.text;

   现在，你就可以使用别名了.

   回到讲述我们实际代码的作用，第一件事是创建一个List对象，并传入一个布尔类型的参数告诉List生成的是有序或无序列表.默认是False(也就是无序列表),然后为List加入了5个项。第一个项是通过匿名函数传入String参数类型来创建ListItem并传入，从第二个开始，则是直接传入String类型的参数.最后是创建一个Paragraph对象和list对象共同传入document.

   

    如上图所见，每一个列表项都像Paragraph那样自己单占一行.还有列表是无序列表，每一个列表项之前都用一个横杠作为修饰，并且列表没有缩进。但iTextSharp提供了多种方法允许设置列表使其更加美观：

it.List list = new it.List(it.List.UNORDERED, 10f);
 
list.SetListSymbol("\u2022");
 
list.IndentationLeft = 30f;

   

    上面第二个参数（float类型)传入List的构造函数，用于将每一个列表项的缩进设置成10(也就是列表符号和列表项第一个字符的距离。).然后我通过SetListSymbol方法将列表项符号改成更传统的”.”,最后我将整个列表向右缩进30，现在列表看起来就好多了：

     

   如果你使用有序列表并将罗马数字作为标识，你可以使用RomanList类：

RomanList romanlist = new RomanList(true, 20);
 
romanlist.IndentationLeft = 30f;
 
romanlist.Add("One");
 
romanlist.Add("Two");
 
romanlist.Add("Three");
 
romanlist.Add("Four");
 
romanlist.Add("Five");
 
doc.Add(romanlist);

  

    由于某些奇怪的理由，传入RomanList构造函数的第二个参数是一个Int类型的值，第一个参数告诉RomanList究竟使用大写还是小写作为行项目标识:

   

     还有一个GreekList类支持使用希腊字符作为列表项目的标识，还有其它两个类ZapfDingbatsList 和ZapfDingbatsNumberList，由于他们使用了ZapfDingBats字体，所以这两个类对列表项符号提供了更多丰富的选项，希腊和罗马字符作为行项目标识时，分别不能超过24和26个行项目,而ZapfDingBatsNumberList最多只能处理10个字符，当字符超出范围后，列表又会从0开始.

ZapfDingbatsList zlist = new it.ZapfDingbatsList(49, 15);
 
zlist.Add("One");
 
zlist.Add("Two");
 
zlist.Add("Three");
 
zlist.Add("Four");
 
zlist.Add("Five");
 
doc.Add(zlist);

  

    列表之间还可以相互嵌套，因为List.Add()方法接受一个Object类型的参数,所以你只要传入一个有效的List对象就行。下面代码首先创建了一个RomanList对象，然后再创建一个有序列表.我们将RomanList对象添加到有序列表上，则RomanList会相对于父有序列表自动向后缩进:

RomanList romanlist = new RomanList(true, 20);
 
romanlist.IndentationLeft = 10f;
 
romanlist.Add("One");
 
romanlist.Add("Two");
 
romanlist.Add("Three");
 
romanlist.Add("Four");
 
romanlist.Add("Five");
 
 
 
List list = new List(List.ORDERED, 20f);
 
list.SetListSymbol("\u2022");
 
list.IndentationLeft = 20f;
 
list.Add("One");
 
list.Add("Two");
 
list.Add("Three");
 
list.Add("Roman List");
 
list.Add(romanlist);
 
list.Add("Four");
 
list.Add("Five");
 
 
 
doc.Add(paragraph);
 
doc.Add(list);

    

-----------------
原文链接:Lists with iTextSharp
translated by CareySon