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 posicionable propiedad de PagedPlan o referenciado por él

Después de la medición, materializa un arreglo 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 el arreglo 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 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 queda vacío por diseño; la configuración de páginas, el número de páginas, los elementos semánticos, los conteos de contenido, las mediciones y los totales estables de referencias de página siguen disponibles

PagedPlan.MaterializePage puede restaurar una página completa más adelante, 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 requiera un plan de comandos completo en memoria y posprocesamiento del árbol de estructura

PDFium retiene el documento creado y sus páginas nativas hasta guardar o cerrar, de modo que esta API acota la materialización de comandos de alto nivel en lugar de la memoria del documento de PDFium

Cualquier PDF de origen 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 agregada por la llamada

See Also

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