PDFium Delphi Component Docs

GeneratePagedLayout Méthode

Composant: TPdf  ·  Units: PDFium, FPdfLayout

Syntax

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

Description

Mesure et pagine la mise en page tout en sérialisant chaque commande dans le stockage adressable appartenant à ou référencé par PagedPlan

Après la mesure, la méthode matérialise un tableau de commandes de page à la fois, émet cette page via les mêmes API natives d’objets de page PDFium que GenerateLayout, la vidange, libère le tableau local et passe à la page suivante

Storage and cache

Utilisez un TFileStream, un TMemoryStream ou un TPdfRandomAccessStore dédié ; le flux doit prendre en charge seek, read, write, resize et un usage exclusif pendant toute la durée de vie du plan paginé

MaxCommandCount, MaxStorageBytes, MaxPageCommands et MaxSourceCount rejettent les plans excessifs, tandis que MaxCachedPages borne le cache LRU interne et peut valoir zéro

CommandCount, StorageByteCount, les compteurs de cache et l’occupation crête exposent un comportement mesurable

Result

Plan.Commands est vide par conception ; les réglages de page, le nombre de pages, les éléments sémantiques, les compteurs de contenu, les mesures et les totaux de références de page stables restent disponibles

PagedPlan.MaterializePage peut restaurer ultérieurement une page complète, corps compris ainsi que les segments d’en-tête et de pied écrits séparément

Limitations and safety

Cette méthode génère une mise en page non balisée ; utilisez GenerateTaggedLayout lorsqu’un plan de commandes complet en mémoire et un post-traitement de l’arborescence de structure sont requis

PDFium conserve le document rédigé et ses pages natives jusqu’à la sauvegarde ou la fermeture ; cette API borne donc la matérialisation des commandes de haut niveau et non la mémoire du document PDFium

Tout PDF source référencé ou TPdfLayoutCachedNode doit survivre à la génération et aux matérialisations ultérieures, et les destinations signées exigent une autorisation explicite

Un échec de mesure ou d’émission réinitialise le stockage de commandes incomplet et annule chaque page ajoutée par l’appel

See Also

GenerateLayout, GenerateTaggedLayout, FPdfLayout, Stockage de travail à accès aléatoire