THPDFLayoutDiagnostic Record
Ein strukturiertes Layout-Ereignis: was geschah und warum, die beteiligte Seite und das Rechteck, Zeilenanzahlen, Elementpfade und die optionale Quellcode-Position des Elements
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;Unit
HPDFDoc
Felder
| Feld | Zweck |
|---|---|
Kind | THPDFLayoutDiagnosticKind-Ereignistyp, etwa ldkAutomaticPageBreak oder ldkKeepWithNext |
PageIndex | Nullbasierte Seite, auf der das Ereignis auftrat |
RelatedPageIndex | Gepaarte Seite für seitenübergreifende Ereignisse, etwa wenn ein Element auf die nächste Seite aufgeteilt wird |
X / Y / Width / Height | Am Ereignis beteiligtes Platzierungsrechteck, in denselben Größen wie THPDFLayoutBounds |
LineCount | Anzahl der beteiligten Textzeilen, etwa die vor einem automatischen Umbruch gesetzten Zeilen |
Reason | Menschenlesbare Erklärung, warum das Ereignis aufgezeichnet wurde |
ElementPath | Pfad des Layout-Elements, zu dem das Ereignis gehört |
RelatedElementPath | Pfad des gepaarten Elements bei Überlappungs- und Aufteilungsevents |
SourceFile / SourceLine / SourceColumn | Deklarationsstelle, erfasst über SetDiagnosticSource, wenn die Quellpositions-Erfassung aktiv ist |
Verwendungshinweise
- Records erzeugt die Layout-Engine, solange Diagnosen aktiv sind; geliefert werden sie über
THotPDF.GetLayoutDiagnostics,THotPDF.GetLayoutDiagnosticoder das EreignisOnLayoutDiagnostic - Filtern Sie über
KindplusElementPath, und zeigen SieReasondirekt in Logs oder Problemlisten an - Die Rechteckfelder speisen
THotPDF.DrawLayoutDiagnosticOverlay, sodass sich Ereignisse direkt auf der gerenderten Seite visualisieren lassen