Layout Görsel Tanılamaları

HotPDF, sınırlı layout kararlarını tutabilir, yerleştirilen çakışan element'leri algılayabilir, native vector overlay'ler çizebilir, çağıranın sağladığı kaynak konumları ekleyebilir ve senkron önizleme bildirimleri yayımlayabilir

Güvenli varsayılanlar

THPDFLayoutDiagnosticOptions.Default element path'lerini tutar; source-location yakalama, overlap algılama, PDF overlay'leri ve canlı callback'ler ise varsayılan olarak devre dışıdır

İlgili seçenek açıkça etkinleştirilmedikçe, üretilen PDF'e hiçbir kaynak dosya adı veya overlay içeriği girmez

Görsel tanılamayı etkinleştirme

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, bir THPDFLayoutElement üzerinde isteğe bağlı dosya, satır ve sütun saklar; ClearDiagnosticSource ise eşlemeyi kaldırır

Deklaratif layout devam ettirmeleri, sayfa bölünmeleri boyunca kararlı bir çağrı noktası korumak için eşlemeyi kopyalar

Tanılama kayıtları

THPDFLayoutDiagnostic; sayfa, dikdörtgen, satır sayısı, tür ve nedenin yanı sıra ElementPath, RelatedElementPath, SourceFile, SourceLine ve SourceColumn alanlarını içerir

ldkOverlap, başarıyla yerleştirilmiş iki element arasındaki kesişimi; ldkOverflow ise verilen sınırlara sığamayan bir element'i tanımlar

Vector overlay'ler ve canlı önizleme

Overflow dikdörtgenleri kırmızı, overlap dikdörtgenleri turuncu stroke kullanır; isteğe bağlı etiketler ShowOverlayLabels ile kontrol edilir

Overlay'ler, raster görüntüler değil native PDF path'leri ve metindir

LivePreview etkin olduğunda THPDFLayoutDiagnosticEvent, tutulan her tanılamayı isteğe bağlı overlay çiziminin ardından senkron olarak alır

Bütçeler ve istatistikler

MaxTrackedBounds tutulan yerleştirme dikdörtgenlerini, MaxOverlapComparisons ise tanılama aralığı boyunca kesişim işini sınırlar

THPDFLayoutDiagnosticStatistics, tutulan ve atılan tanılamaları, izlenen ve atılan sınırları, overlap karşılaştırma ve bulgularını, çizilen overlay'leri ve canlı bildirimleri raporlar