《iTextSharp 使用手册》中文版是一份详尽的指导文件,涵盖48页内容,旨在帮助用户全面掌握iTextSharp库的各项功能和使用方法。
iTextSharp是基于Java的iText库的一个.NET版本,它是一个功能强大的工具包,在.NET环境中用于创建与操作PDF文档。《iTextSharp使用手册中文版》详细介绍如何利用该库进行PDF文件的操作。
### 创建PDF文档的基本步骤
1. **初始化Document对象**
- `Document document = new Document();`
- 这是生成新PDF的起点,`Document`类代表整个文档结构。创建时可以选择默认A4尺寸或自定义页面大小与边距。
2. **为文件写入准备Writer实例**
- `PdfWriter.getInstance(document, new FileStream(Chap0101.pdf, FileMode.Create));`
- 接下来需要一个`Writer`来处理文档的输出。通过调用静态方法`getInstance()`,可以创建与已初始化Document对象关联的PDF文件写入器。
3. **打开文档**
- `document.Open();`
- 在添加任何内容之前必须先开启文档。
4. **向文档内加入元素**
- `document.Add(new Paragraph(Hello World));`
- 使用`Add()`方法可以将各种类型的元素(如文本、图片等)添加到PDF中。这些元素需要继承自`iTextSharp.text.Element`接口。
5. **关闭文档**
- `document.Close();`
- 在完成所有内容的添加后,调用Close()确保所有的信息都被正确写入,并释放资源。
### 字体与中文支持
直接向PDF文件中加入中文可能会遇到显示问题。因为默认字体不包含对中文字符的支持。手册将在第九章详细讲解如何解决这个问题。
### 自定义页面布局和边距设置
- **定制尺寸**:可以使用`Rectangle`类来设定非标准的页面大小,例如:
- `Rectangle pageSize = new Rectangle(144, 720);`
- `pageSize.BackgroundColor = new Color(0xFF, 0xFF, 0xDE);`
- `Document document = new Document(pageSize);`
- **边距调整**:通过`Document`的构造函数可以设置页面边距:
- `Document document = new Document(PageSize.A5, 36, 72, 108, 180);`
这里定义了上下左右四个方向的页边距离,单位是磅。
### 单位与排版
在调整页面布局时需注意使用的度量标准。iTextSharp默认使用的是基于点(point)的单位系统,并且可以转换为厘米、英寸或像素等其他形式。
例如:1英寸约等于72个点。设计文档大小和边距时应考虑到这一点。
### Writer实例
创建完Document之后,可以通过`PdfWriter.getInstance()`方法来生成输出流对象以写入PDF内容:
- `PdfWriter writer = PdfWriter.getInstance(document, stream);`
另外,如果需要导出TeX格式的文件,则可以使用特定于TeX的写入器类。
### 注意事项
修改页面尺寸仅影响后续页;边距调整则会影响整个文档。对于非ASCII字符(如中文),正确配置字体是关键。
手册中还提到由于OCR技术可能导致部分文字识别不准确,读者需要自行检查并校正文本内容以确保其准确性。实际操作iTextSharp时应仔细阅读手册,并根据具体应用需求进行实践调整。