Diagnostica Visiva del Layout

HotPDF può conservare le decisioni di layout con limiti, rilevare gli elementi sovrapposti posizionati, disegnare overlay vettoriali nativi, allegare posizioni sorgente fornite dal chiamante e pubblicare notifiche di anteprima sincrone

Impostazioni predefinite sicure

THPDFLayoutDiagnosticOptions.Default conserva i percorsi degli elementi, mentre l'acquisizione della posizione sorgente, il rilevamento dell'overlap, gli overlay PDF e le callback live sono disabilitati per impostazione predefinita

Nessun nome di file sorgente o contenuto di overlay entra nel PDF generato a meno che l'opzione corrispondente non sia abilitata esplicitamente

Abilita la diagnostica visiva

Options := THPDFLayoutDiagnosticOptions.Default;
Options.CaptureSourceLocation := True;
Options.DetectOverlaps := True;
Options.DrawOverlays := True;
Options.LivePreview := True;
PDF.LayoutDiagnosticOptions := Options;
PDF.OnLayoutDiagnostic := HandleLayoutDiagnostic;

Element.SetDiagnosticSource('invoice_layout.pas', 73, 9);

SetDiagnosticSource archivia un file, una riga e una colonna opzionali su un THPDFLayoutElement; ClearDiagnosticSource rimuove la mappatura

Le continuazioni del layout dichiarativo copiano la mappatura per preservare un call site stabile tra le suddivisioni delle pagine

Record diagnostici

THPDFLayoutDiagnostic include ElementPath, RelatedElementPath, SourceFile, SourceLine e SourceColumn oltre a pagina, rettangolo, conteggio di righe, tipo e motivo

ldkOverlap identifica un'intersezione tra due elementi posizionati con successo, mentre ldkOverflow identifica un elemento che non ha potuto rientrare nei limiti forniti

Overlay vettoriali e anteprima live

I rettangoli di overflow usano un tratto rosso e i rettangoli di overlap un tratto arancione, con etichette opzionali controllate da ShowOverlayLabels

Gli overlay sono percorsi e testo PDF nativi anziché immagini raster

THPDFLayoutDiagnosticEvent riceve ogni diagnostica conservata in modo sincrono dopo il disegno dell'overlay opzionale quando LivePreview è abilitato

Budget e statistiche

MaxTrackedBounds limita i rettangoli di posizionamento conservati e MaxOverlapComparisons limita il lavoro di intersezione sull'intervallo diagnostico

THPDFLayoutDiagnosticStatistics riporta le diagnostiche conservate e scartate, i limiti tracciati e scartati, i confronti e i reperti di overlap, gli overlay disegnati e le notifiche live