Registro THPDFLayoutDiagnostic
Un evento de diseño estructurado: qué ocurrió y por qué, la página y el rectángulo implicados, recuentos de líneas, rutas de elementos y la ubicación opcional en el código fuente del elemento
Declaración
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;Unidad
HPDFDoc
Campos
| Campo | Propósito |
|---|---|
Kind | THPDFLayoutDiagnosticKind con el tipo de evento, como ldkAutomaticPageBreak o ldkKeepWithNext |
PageIndex | Página basada en cero donde ocurrió el evento |
RelatedPageIndex | Página emparejada para eventos entre páginas, como un elemento que se divide hacia la página siguiente |
X / Y / Width / Height | Rectángulo de colocación implicado en el evento, en los mismos términos que THPDFLayoutBounds |
LineCount | Número de líneas de texto implicadas, por ejemplo las líneas maquetadas antes de un salto automático |
Reason | Explicación legible de por qué se registró el evento |
ElementPath | Ruta del elemento de diseño al que pertenece el evento |
RelatedElementPath | Ruta del elemento emparejado para eventos de solapamiento y división |
SourceFile / SourceLine / SourceColumn | Sitio de declaración capturado mediante SetDiagnosticSource cuando la captura de ubicación de fuente está activada |
Notas de uso
- Los registros los produce el motor de diseño mientras los diagnósticos están activados, y se entregan mediante
THotPDF.GetLayoutDiagnostics,THotPDF.GetLayoutDiagnostico el eventoOnLayoutDiagnostic - Use
Kindjunto conElementPathpara filtrar, yReasonpara mostrarlo directamente en registros o listas de incidencias - Los campos de rectángulo alimentan
THotPDF.DrawLayoutDiagnosticOverlay, de modo que los eventos se pueden visualizar directamente en la página renderizada