Enregistrement THPDFLayoutDiagnosticOptions
Interrupteurs et budgets pour les diagnostics de mise en page : capture du chemin d'élément et de la position source, détection de chevauchements, dessin et étiquettes d'overlay, notifications d'aperçu live et limites de suivi
Déclaration
THPDFLayoutDiagnosticOptions= record
CaptureElementPath: boolean;
CaptureSourceLocation: boolean;
DetectOverlaps: boolean;
DrawOverlays: boolean;
ShowOverlayLabels: boolean;
LivePreview: boolean;
MaxTrackedBounds: Integer;
MaxOverlapComparisons: Int64;
class function Default: THPDFLayoutDiagnosticOptions; static;
end;Unité
HPDFDoc
Champs
| Champ | Objectif |
|---|---|
CaptureElementPath | Enregistre la chaîne ElementPath de chaque diagnostic ; défaut True |
CaptureSourceLocation | Enregistre le fichier source, la ligne et la colonne attachés à l'élément ; défaut False |
DetectOverlaps | Suit les rectangles posés et les compare deux à deux pour les chevauchements ; défaut False |
DrawOverlays | Dessine les rectangles de diagnostic sur la page pendant le rendu ; défaut False |
ShowOverlayLabels | Annote les overlays dessinés avec leur texte de raison ; défaut True |
LivePreview | Pousse des notifications de diagnostic pendant l'édition interactive ; défaut False |
MaxTrackedBounds | Nombre maximal de rectangles conservés pour le suivi et les tests de chevauchement ; défaut 4096 |
MaxOverlapComparisons | Nombre maximal de comparaisons de rectangles deux à deux par exécution avant arrêt de la détection ; défaut 1000000 |
Default | Fonction de classe renvoyant les valeurs listées ci-dessus |
Notes d'utilisation
- Partez de
THPDFLayoutDiagnosticOptions.Default, ne changez que les interrupteurs dont vous avez besoin, et affectez-le viaTHotPDF.SetLayoutDiagnosticOptionsou la propriétéLayoutDiagnosticOptions - Activez
DetectOverlapsseulement autour des exécutions de mise en page qui vous importent : les comparaisons sont bornées parMaxOverlapComparisonsmais coûtent quand même du temps sur les grands documents - Associez
DrawOverlaysàShowOverlayLabelspour le débogage visuel, et lisezTHPDFLayoutDiagnosticStatisticspour voir ce qui a été suivi, comparé et dessiné