ComPDF
联系销售
文档DemoDownloadFAQ更新日志

核心概念 ​

文档结构 ​

布局 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 结构来表示尺寸值，支持两种单位：

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

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

颜色系统 ​

使用 CColor 结构定义 RGBA 颜色：

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

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