THPDFLayoutDiagnosticOptions Record
版面診斷的開關與預算:元素路徑與來源位置擷取、重疊偵測、疊加繪製與標籤、即時預覽通知,以及追蹤上限
宣告
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檢視追蹤、比較與繪製了什麼