核心概念

文档结构

布局 API 采用树形结构组织文档内容：

CDocument (文档)
  ├─ CPage (页面)
  │   ├─ CDiv (容器)
  │   │   ├─ CParagraph (段落)
  │   │   ├─ CTable (表格)
  │   │   ├─ CList (列表)
  │   │   ├─ CImage (图片)
  │   │   ├─ CText (文本)
  │   │   └─ CLineSeparator (分隔线)
  │   └─ ... (其他元素)
  └─ CStyle (样式)

元素类型

1. 容器元素

• CDocument：PDF 文档的根容器，可包含多个页面
• CPage：表示 PDF 的一个页面，可包含各种布局元素
• CDiv：通用容器元素，类似于 HTML 中的 div，用于组织内容
• CParagraph：段落容器，支持行间距和首行缩进
• CTable：表格元素，支持单元格合并、表头、表尾
• CCell：表格单元格
• CList：列表容器，支持有序和无序列表
• CListItem：列表项

2. 内容元素

• CText：文本元素，可设置字体、颜色、大小等
• CImage：图片元素，支持多种缩放模式

3. 其他元素

• CLineSeparator：水平分隔线
• CStyle：可重用的样式定义

单位系统

布局 API 使用 CUnitValue 结构来表示尺寸值，支持两种单位：

// 点（Point）单位 - 1 点 = 1/72 英寸
CUnitValue pointValue = CUnitValue.CreatePointValue(100f);

// 百分比单位
CUnitValue percentValue = CUnitValue.CreatePercentValue(50f);

颜色系统

使用 CColor 结构定义 RGBA 颜色：

// 使用 RGBA 值创建颜色
CColor color = new CColor(255, 0, 0, 255); // 红色,完全不透明

// 使用预定义颜色
CColor black = CColor.BLACK;
CColor white = CColor.WHITE;
CColor red = CColor.RED;