THPDFLayoutDiagnostic Record
En strukturerad layouthändelse: vad som hände och varför, sidan och rektangeln det gäller, radantal, elementsökvägar och elementets valfria källkodsplats
Deklaration
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;Enhet
HPDFDoc
Fält
| Fält | Syfte |
|---|---|
Kind | THPDFLayoutDiagnosticKind-händelsetyp, till exempel ldkAutomaticPageBreak eller ldkKeepWithNext |
PageIndex | Nollbaserad sida där händelsen inträffade |
RelatedPageIndex | Den kopplade sidan för händelser över sidgränser, till exempel ett element som delas över på nästa sida |
X / Y / Width / Height | Placeringsrektangeln som händelsen gäller, i samma termer som THPDFLayoutBounds |
LineCount | Antal textrader som berörs, till exempel raderna som satts upp innan en automatisk brytning |
Reason | Människoläsbar förklaring till varför händelsen registrerades |
ElementPath | Sökvägen till det layoutelement som händelsen hör till |
RelatedElementPath | Sökvägen till det kopplade elementet vid överlapps- och delningshändelser |
SourceFile / SourceLine / SourceColumn | Deklarationsplatsen som fångats via SetDiagnosticSource när insamling av källplats är aktiverad |
Användningsanteckningar
- Records produceras av layoutmotorn medan diagnostiken är aktiverad och levereras via
THotPDF.GetLayoutDiagnostics,THotPDF.GetLayoutDiagnosticeller händelsenOnLayoutDiagnostic - Använd
KindplusElementPathför filtrering ochReasonför direkt visning i loggar eller fellistor - Rektangelfälten matar
THotPDF.DrawLayoutDiagnosticOverlay, så att händelserna kan visualiseras direkt på den renderade sidan