QuestPDF API 参考

视觉元素

• 文本 - 支持绘制不同样式的文本。
• 图像 - 以已知或动态大小绘制图片。
• 背景 - 在其子元素下方应用实心背景颜色。
• 边框 - 在其子元素周围应用实心边框。
• 线段 - 绘制垂直或水平线。
• 占位符 - 为原型设计绘制简单的占位符图片。

定位元素

• 宽度 - 对其子元素应用最小和/或最大宽度约束。
• 高度 - 对其子元素应用最小和/或最大高度约束。
• 对齐 - 允许您精确指定子元素的位置，例如居中，或左下角。
• 内边距 - 在其子元素周围应用空白空间。
• 宽高比 - 保留具有指定宽高比的区域。
• 扩展 - 水平和/或垂直扩展子元素大小以适应全部内容。
• 最小盒子 - 将子元素大小缩小到最小可能。当父元素提供的空间超过所需的范围时很有用。
• 移动 - 在水平和/或垂直方向上虚拟移动子元素。
• 旋转 - 旋转其子元素。
• 缩放 - 放大或缩小其子元素。
• 等比例缩放 - 缩放其子元素以适应可用空间。
• 翻转 - 以 90 度增量旋转其子元素。
• 无约束 - 删除所有尺寸约束，给其子元素提供无限空间。

内容流元素

• 分页符 - 强制后续内容移到下一页。
• 显示条件 - 根据条件显示其子元素。
• 只显示一次 - 只在首次出现的第一页上显示其子元素。该元素在后续页面上不可见。
• 跳过一次 - 在首次出现的第一页上隐藏其子元素。该元素在所有后续页面上可见。
• 完整显示 - 确保元素在一个页面上完全可见，不进行分页。
• 确保空间 - 是ShowEntire元素的宽松版本。如果一个页面上没有足够的空间来完全显示元素，它会确保首次出现的页面至少有指定的最小大小。用于优化布局视觉效果。
• 停止分页 - 只在第一页上显示其元素。如果元素的一部分无法完全显示，则忽略它。

布局元素

• 页面 - 允许您管理页面设置，如大小、边距、颜色、水印等。
• 表格 - 使用表格布局算法排列其子元素。支持行和列跨越。
• 列 - 横向放置其子元素，一个在另一个下面。
• 行 - 纵向放置其子元素，一个挨着另一个。
• 网格 - 使用网格布局算法排列其子元素。可用空间被划分为一组等间距的列。其子元素可以占据任何数量的列。
• 内联 - 沿行绘制其元素。支持各种元素对齐方式。
• 装饰 - 在其子元素之前和/或之后放置附加内容。附加内容将在所有页面上重复。
• 层叠 - 在其子元素之下和/或之上放置附加内容。附加内容将在所有页面上重复。用于实现水印时很有用。
• 列表 - 以有序或无序列表形式绘制其子元素。

其他元素

• 节 - 指定跨其子元素的多页区域。用于创建内部文档链接和显示自定义页面编号。
• 节链接 - 创建链接到指定节的链接。将用户重定向到包含该节首次出现的页面。
• 超链接 - 创建链接到外部位置，例如将用户重定向到网页。
• 元素 - 允许您中断 Fluent API 链，并使用 lambda 表达式注入动态内容。
• 默认文本样式 - 应用额外的文本样式，应用于其层次结构内的所有文本元素。
• 调试区域 - 在其子元素周围绘制带标签的彩色框。用于设计目的。
• 调试指针 - 为其子元素标记特殊标签。当库抛出与布局相关的异常时，该标签有助于更好地理解文档结构。