THPDFLayoutDiagnostic Record
Eén gestructureerde layoutgebeurtenis: wat er gebeurde en waarom, de betrokken pagina en rechthoek, regelaantallen, elementpaden en de optionele broncodelocatie van het element
Declaratie
THPDFLayoutDiagnostic= record
Kind: THPDFLayoutDiagnosticKind;
PageIndex: Integer;
RelatedPageIndex: Integer;
X: Single;
Y: Single;
Width: Single;
Height: Single;
LineCount: Integer;
Reason: AnsiString;
ElementPath: AnsiString;
RelatedElementPath: AnsiString;
SourceFile: AnsiString;
SourceLine: Integer;
SourceColumn: Integer;
end;Eenheid
HPDFDoc
Velden
| Veld | Doel |
|---|---|
Kind | THPDFLayoutDiagnosticKind-eventtype, zoals ldkAutomaticPageBreak of ldkKeepWithNext |
PageIndex | Nulgebasererde pagina waarop het event plaatsvond |
RelatedPageIndex | Gekoppelde pagina voor events over pagina's heen, zoals een element dat op de volgende pagina wordt voortgezet |
X / Y / Width / Height | Plaatsingsrechthoek die bij het event betrokken is, in dezelfde termen als THPDFLayoutBounds |
LineCount | Aantal betrokken tekstregels, bijvoorbeeld de regels die vóór een automatisch pagina-einde zijn gezet |
Reason | Menselijk leesbare uitleg waarom het event is vastgelegd |
ElementPath | Pad van het layoutelement waartoe het event behoort |
RelatedElementPath | Pad van het gekoppelde element bij overlap- en split-events |
SourceFile / SourceLine / SourceColumn | Declaratieplek die via SetDiagnosticSource is vastgelegd wanneer het vastleggen van bronlocaties is ingeschakeld |
Gebruiksopmerkingen
- Records worden door de layoutengine geproduceerd zolang diagnostiek aan staat en worden geleverd via
THotPDF.GetLayoutDiagnostics,THotPDF.GetLayoutDiagnosticof het eventOnLayoutDiagnostic - Gebruik
KindplusElementPathom te filteren, enReasonvoor directe weergave in logs of issuelijsten - De rechthoekvelden voeden
THotPDF.DrawLayoutDiagnosticOverlay, zodat events direct op de gerenderde pagina gevisualiseerd kunnen worden