Diagnósticos visuais de layout

O HotPDF pode reter decisões de layout limitadas, detectar elementos posicionados sobrepostos, desenhar sobreposições vetoriais nativas, anexar localizações de origem fornecidas pelo chamador e publicar notificações de pré-visualização síncronas

Padrões seguros

THPDFLayoutDiagnosticOptions.Default retém caminhos de elemento, enquanto captura de localização de origem, detecção de sobreposição, sobreposições PDF e retornos de chamada ao vivo são desabilitados por padrão

Nenhum nome de arquivo de origem ou conteúdo de sobreposição entra no PDF gerado a menos que a opção correspondente seja explicitamente habilitada

Habilitar diagnósticos visuais

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 armazena um arquivo, linha e coluna opcionais em um THPDFLayoutElement; ClearDiagnosticSource remove o mapeamento

Continuações de layout declarativo copiam o mapeamento para preservar um local de chamada estável entre divisões de página

Registros de diagnóstico

THPDFLayoutDiagnostic inclui ElementPath, RelatedElementPath, SourceFile, SourceLine e SourceColumn além de sua página, retângulo, contagem de linhas, tipo e motivo

ldkOverlap identifica uma interseção entre dois elementos posicionados com sucesso, enquanto ldkOverflow identifica um elemento que não coube nos limites fornecidos

Sobreposições vetoriais e pré-visualização ao vivo

Retângulos de estouro usam um traço vermelho e retângulos de sobreposição usam um traço laranja, com rótulos opcionais controlados por ShowOverlayLabels

Sobreposições são caminhos e texto PDF nativos em vez de imagens raster

THPDFLayoutDiagnosticEvent recebe cada diagnóstico retido de forma síncrona após o desenho opcional de sobreposição quando LivePreview está habilitado

Orçamentos e estatísticas

MaxTrackedBounds limita os retângulos de posicionamento retidos e MaxOverlapComparisons limita o trabalho de interseção no intervalo de diagnóstico

THPDFLayoutDiagnosticStatistics relata diagnósticos retidos e descartados, limites rastreados e descartados, comparações e achados de sobreposição, sobreposições desenhadas e notificações ao vivo