# Itext7

**Repository Path**: JackZhang3/itext7

## Basic Information

- **Project Name**: Itext7
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-12-05
- **Last Updated**: 2025-12-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# iText 7 学习示例

这个项目包含了 iText 7 库的基本使用示例，展示了如何创建 PDF 文档。

## 项目结构

- `BasicExample.csproj` - 基础示例项目
- `Program.cs` - 基础示例：创建一个包含"Hello World"的简单 PDF
- `AdvancedExample.csproj` - 高级示例项目
- `AdvancedExample.cs` - 高级示例：展示更多构建块如段落、列表等
- `CompleteExample.csproj` - 完整示例项目
- `CompleteExample.cs` - 完整示例：展示更多高级功能如字体、颜色、边框等
- `itext7.sln` - Visual Studio 解决方案文件
- `run_examples.bat` - Windows 批处理脚本，用于运行所有示例
- `run_examples.sh` - Linux/macOS Shell 脚本，用于运行所有示例
- `Chapter1_Basic_Building_Blocks_zh.md` - 第一章：基本构建块（中文版）
- `iText7_Complete_Guide_zh.md` - iText 7 完整指南（中文版）
- `iText7_Core_Concepts.md` - iText 7 核心概念详解

## 构建状态

![构建状态](https://img.shields.io/badge/build-success-brightgreen)

## iText 7 基本构建块

根据 iText 文档第一章介绍，主要的构建块包括：

1. **Document** - 主要的文档对象，用于添加内容
2. **Paragraph** - 段落元素，用于添加文本内容
3. **List** - 列表元素，用于创建有序或无序列表
4. **Image** - 图像元素，用于在 PDF 中插入图片
5. **Chunk** - 最小的文本单位（在 iText 7 中较少直接使用）
6. **Table** - 表格元素，用于创建数据表格
7. **Cell** - 表格单元格

## 核心类

1. **PdfWriter** - 负责将 PDF 内容写入文件或流
2. **PdfDocument** - 表示 PDF 文档本身
3. **Document** - 高级抽象，用于添加内容到 PDF

## 运行示例

确保已安装 .NET 6 SDK，然后运行以下命令：

```bash
# 在 Windows 上运行单个示例
dotnet run --project BasicExample.csproj

# 在 Windows 上运行所有示例
run_examples.bat

# 在 Linux/macOS 上运行所有示例
./run_examples.sh
```

第一个示例会生成 `hello_world.pdf` 文件，第二个示例会生成 `advanced_example.pdf` 文件，第三个示例会生成 `complete_example.pdf` 文件。

## 学习建议

1. **从基础开始**：先理解 `Document`、`Paragraph` 和 `List` 等基本构建块的概念和用法。

2. **逐步进阶**：掌握基本构建块后，可以学习更高级的功能如表格、图像、字体设置等。

3. **实践练习**：尝试修改示例代码，创建自己的 PDF 文档。

4. **参考文档**：访问 iText 官方文档获取更多详细信息和高级用法。

5. **错误处理**：在实际应用中，要注意添加适当的异常处理机制。

通过这些示例，你应该对 iText 7 的基本用法有了初步了解。可以在此基础上探索更多高级功能。