Enregistrement THPDFLayoutDiagnostic
Un événement de mise en page structuré : ce qui s'est passé et pourquoi, la page et le rectangle concernés, les comptages de lignes, les chemins d'éléments et la position optionnelle dans le code source de l'élément
Déclaration
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
Champs
| Champ | Objectif |
|---|---|
Kind | Type d’événement THPDFLayoutDiagnosticKind, par exemple ldkAutomaticPageBreak ou ldkKeepWithNext |
PageIndex | Page à base zéro où l'événement s'est produit |
RelatedPageIndex | Page associée pour les événements inter-pages, comme un élément se scindant sur la page suivante |
X / Y / Width / Height | Rectangle de placement concerné par l'événement, dans les mêmes termes que THPDFLayoutBounds |
LineCount | Nombre de lignes de texte concernées, par exemple les lignes posées avant une rupture automatique |
Reason | Explication lisible de la raison pour laquelle l'événement a été enregistré |
ElementPath | Chemin de l'élément de mise en page auquel l'événement appartient |
RelatedElementPath | Chemin de l'élément associé pour les événements de chevauchement et de scission |
SourceFile / SourceLine / SourceColumn | Site de déclaration capturé via SetDiagnosticSource quand la capture de position source est activée |
Notes d'utilisation
- Les enregistrements sont produits par le moteur de mise en page pendant que les diagnostics sont actifs et livrés via
THotPDF.GetLayoutDiagnostics,THotPDF.GetLayoutDiagnosticou l'événementOnLayoutDiagnostic - Utilisez
KindplusElementPathpour filtrer, etReasonpour un affichage direct dans les journaux ou les listes de problèmes - Les champs de rectangle alimentent
THotPDF.DrawLayoutDiagnosticOverlay, si bien que les événements peuvent être visualisés directement sur la page rendue