THPDFLayoutDiagnostic Record
Um evento de layout estruturado: o que aconteceu e por quê, a página e o retângulo envolvidos, contagens de linhas, caminhos de elementos e a localização opcional no código-fonte do elemento
Declaração
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;Unidade
HPDFDoc
Campos
| Campo | Finalidade |
|---|---|
Kind | Tipo de evento THPDFLayoutDiagnosticKind, como ldkAutomaticPageBreak ou ldkKeepWithNext |
PageIndex | Página baseada em zero em que o evento ocorreu |
RelatedPageIndex | Página pareada para eventos entre páginas, como um elemento dividido para a página seguinte |
X / Y / Width / Height | Retângulo de posicionamento envolvido no evento, nos mesmos termos de THPDFLayoutBounds |
LineCount | Número de linhas de texto envolvidas, por exemplo as linhas diagramadas antes de uma quebra automática |
Reason | Explicação legível por humanos do motivo pelo qual o evento foi registrado |
ElementPath | Caminho do elemento de layout ao qual o evento pertence |
RelatedElementPath | Caminho do elemento pareado para eventos de sobreposição e divisão |
SourceFile / SourceLine / SourceColumn | Local de declaração capturado por meio de SetDiagnosticSource quando a captura de localização de origem está ativada |
Notas de uso
- Os records são produzidos pelo motor de layout enquanto os diagnósticos estão ativados e entregues por meio de
THotPDF.GetLayoutDiagnostics,THotPDF.GetLayoutDiagnosticou do eventoOnLayoutDiagnostic - Use
KindmaisElementPathpara filtrar, eReasonpara exibição direta em logs ou listas de problemas - Os campos de retângulo alimentam
THotPDF.DrawLayoutDiagnosticOverlay, de modo que os eventos possam ser visualizados diretamente na página renderizada