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`	配置された矩形を追跡し、オーバーラップを 2 つずつ比較します。既定は `False`
`DrawOverlays`	レンダリング中に診断矩形をページへ描画します。既定は `False`
`ShowOverlayLabels`	描かれたオーバーレイに理由テキストを注記します。既定は `True`
`LivePreview`	対話編集中に診断通知をプッシュします。既定は `False`
`MaxTrackedBounds`	追跡とオーバーラップチェックのために保持される矩形の最大数。既定は `4096`
`MaxOverlapComparisons`	検出が停止するまでの 1 実行あたりの矩形ペア比較の最大数。既定は `1000000`
`Default`	上記の値を返すクラス関数

使用上の注意

THPDFLayoutDiagnosticOptions.Default を起点に必要なスイッチだけを変え、THotPDF.SetLayoutDiagnosticOptions または LayoutDiagnosticOptions プロパティで代入します
DetectOverlaps は必要なレイアウト実行の周辺だけで有効にしてください。比較は MaxOverlapComparisons で頭打ちになりますが、大きなドキュメントではそれでも時間を要します
視覚デバッグでは DrawOverlays と ShowOverlayLabels を組み合わせ、何が追跡・比較・描画されたかは THPDFLayoutDiagnosticStatistics で確認します

THPDFLayoutDiagnosticOptions レコード

宣言

ユニット

フィールド

使用上の注意

関連 API