THPDFLayoutDiagnosticOptions 记录
布局诊断的开关与预算：元素路径和源位置捕获、重叠检测、叠加绘制与标签、实时预览通知，以及跟踪上限
声明
THPDFLayoutDiagnosticOptions= record
CaptureElementPath: boolean;
CaptureSourceLocation: boolean;
DetectOverlaps: boolean;
DrawOverlays: boolean;
ShowOverlayLabels: boolean;
LivePreview: boolean;
MaxTrackedBounds: Integer;
MaxOverlapComparisons: Int64;
class function Default: THPDFLayoutDiagnosticOptions; static;
end;单元
HPDFDoc
字段
| 字段 | 用途 |
|---|---|
CaptureElementPath | 记录每条诊断的 ElementPath 字符串；默认 True |
CaptureSourceLocation | 记录附加到元素的源文件、行和列；默认 False |
DetectOverlaps | 跟踪已放置的矩形并两两比较以检测重叠；默认 False |
DrawOverlays | 渲染时把诊断矩形绘制到页面上；默认 False |
ShowOverlayLabels | 用原因文本标注已绘制的叠加；默认 True |
LivePreview | 交互式编辑期间推送诊断通知；默认 False |
MaxTrackedBounds | 为跟踪和重叠检查保留的矩形数量上限；默认 4096 |
MaxOverlapComparisons | 每轮检测停止前的两两矩形比较次数上限；默认 1000000 |
Default | 返回上述值的类函数 |
使用说明
- 从
THPDFLayoutDiagnosticOptions.Default出发，只改需要的开关，然后通过THotPDF.SetLayoutDiagnosticOptions或LayoutDiagnosticOptions属性赋值 - 只在需要的布局运行前后启用
DetectOverlaps：比较次数受MaxOverlapComparisons约束，但在大文档上仍会消耗时间 - 把
DrawOverlays与ShowOverlayLabels搭配用于可视化调试，并读取THPDFLayoutDiagnosticStatistics查看跟踪、比较和绘制了哪些内容