PDFium Delphi Component Docs

GeneratePagedLayout Método

Componente: TPdf  ·  Unidades: PDFium, FPdfLayout

Syntax

function GeneratePagedLayout(Layout: TPdfLayoutDocument; PagedPlan: TPdfLayoutPagedPlan; out Plan: TPdfLayoutPlan; AllowSignedDocument: Boolean = False): Boolean;

Description

Mide y pagina el diseño mientras serializa cada comando en el almacenamiento buscable poseído o referenciado por PagedPlan

Después de la medición, materializa una matriz de comandos de página a la vez, emite esa página mediante las mismas API nativas de objetos de página de PDFium que GenerateLayout, la vuelca, libera la matriz local y continúa con la página siguiente

Storage and cache

Use un TFileStream, TMemoryStream o TPdfRandomAccessStore dedicado; el flujo debe admitir seek, lectura, escritura, cambio de tamaño y uso exclusivo durante el ciclo de vida del plan paginado

MaxCommandCount, MaxStorageBytes, MaxPageCommands y MaxSourceCount rechazan los planes excesivos, mientras que MaxCachedPages acota la caché LRU interna y puede ser cero

CommandCount, StorageByteCount, los contadores de caché y la ocupación máxima exponen un comportamiento medible

Result

Plan.Commands está vacío por diseño; la configuración de página, el número de páginas, los elementos semánticos, los recuentos de contenido, las mediciones y los totales de referencias de página estables siguen disponibles

PagedPlan.MaterializePage puede restaurar más tarde una página completa, incluido el cuerpo más los segmentos de encabezado y pie escritos por separado

Limitations and safety

Este método genera un diseño sin etiquetar; use GenerateTaggedLayout cuando se necesite un plan de comandos completo en memoria y un posprocesamiento del árbol de estructura

PDFium retiene el documento cargado y sus páginas nativas hasta el guardado o cierre, de modo que esta API acota la materialización de comandos de alto nivel, no la memoria del documento PDFium

Cualquier PDF fuente referenciado o TPdfLayoutCachedNode debe sobrevivir a la generación y a la materialización posterior, y los destinos firmados requieren autorización explícita

Un fallo de medición o de emisión restablece el almacenamiento de comandos incompleto y revierte cada página añadida por la llamada

See Also

GenerateLayout, GenerateTaggedLayout, FPdfLayout, Almacenamiento de trabajo de acceso aleatorio