### ITextSharp文档说明知识点详解
#### 一、ITextSharp简介
- **ITextSharp**是一款用于生成、操作PDF文件的开源库，支持.NET平台。它提供了丰富的API，允许开发者轻松地创建、修改和操作PDF文件。
#### 二、创建PDF文件的基本步骤
根据给定的内容，创建PDF文件主要分为五个步骤：
1. **创建Document对象**:
- 使用`Document`类创建一个实例。此实例代表了一个PDF文档。
- 可以通过不同的构造函数来定制页面大小和页边距等属性。
2. **创建Writer实例**:
- 通过`PdfWriter.getInstance`方法为`Document`对象创建一个`PdfWriter`实例。这个实例负责将文档内容写入文件或流。
- `PdfWriter`是`DocWriter`的子类，用于处理PDF文档。
3. **打开Document**:
- 在向文档添加内容之前，需要先调用`Document.open()`方法来打开文档。
4. **添加内容**:
- 使用`Document.add`方法向文档添加内容，如文本段落、图片等。
5. **关闭Document**:
- 完成内容添加后，调用`Document.close()`方法来关闭文档并完成文件的生成。
#### 三、创建Document实例详解
- **构造函数**:
- `Document()`: 默认构造函数，创建一个具有默认设置（A4纸张大小和标准页边距）的文档。
- `Document(Rectangle pageSize)`: 指定页面大小创建文档。
- `Document(Rectangle pageSize, int marginLeft, int marginRight, int marginTop, int marginBottom)`: 自定义页面大小和页边距创建文档。
- **页面尺寸**:
- 可以通过指定尺寸和颜色来创建自定义页面。例如：
```csharp
Rectangle pageSize = new Rectangle(144, 720);
pageSize.BackgroundColor = new Color(0xFF, 0xFF, 0xDE);
Document document = new Document(pageSize);
```
- 提供了多种预定义的页面尺寸，如A0-A10, LEGAL, LETTER等。
- 如果需要横向页面，可以使用`rotate()`方法，例如：
```csharp
Document document = new Document(PageSize.A4.rotate());
```
- **页边距**:
- 创建文档时可以通过构造函数设置页边距。
```csharp
Document document = new Document(PageSize.A5, 36, 72, 108, 180);
```
- 上述代码创建了一个具有不同页边距的文档，其中左右页边距分别为0.5英寸和1英寸，上下页边距分别为1.5英寸和2.5英寸。
- **度量单位**:
- 默认的度量单位为磅（point），1英寸等于72磅。
- 若要创建一个A4大小的页面，其尺寸约为595磅宽和842磅高。
#### 四、创建Writer实例
- **使用PdfWriter**:
- `PdfWriter`是用于创建PDF文档的主要类。
- 通过`PdfWriter.getInstance`方法创建一个`PdfWriter`实例，传递`Document`对象和输出流。
```csharp
PdfWriter.getInstance(document, new FileStream("Chap0101.pdf", FileMode.Create));
```
#### 五、其他高级功能
- **字体处理**:
- 默认情况下，文档中的中文无法正常显示。在后续章节中会详细介绍如何解决中文显示问题。
通过以上内容，我们了解到使用ITextSharp创建PDF文档的基本流程以及一些高级定制选项。这对于希望在.NET项目中集成PDF生成能力的开发者来说是非常有用的。
