LoadCustomDocument Méthode

Charge un PDF depuis n’importe quel TStream à accès positionnable grâce au lecteur de blocs à la demande de PDFium, si bien que les documents de plusieurs Go et les sources distantes ou adossées à une base de données ne nécessitent pas de copie en mémoire préalable

LoadCustomDocument est l’équivalent en flux des surcharges bufférisées de LoadDocument. Il s’appuie sur le point d’entrée FPDF_LoadCustomDocument de PDFium via la classe auxiliaire TPdfStreamAdapter introduite dans la v1.8.0 PDFium tire des blocs de AStream uniquement lorsque nécessaire, si bien que le flux n’est pas copié en mémoire : un TFileStream sur un PDF de 4 Go, un TStream adossé à HTTP ou un flux de BLOB de base de données deviennent utilisables sans stocker d’abord la charge complète en RAM

AStream doit prendre en charge le repositionnement. Sa durée de vie doit s’étendre jusqu’à la fermeture du document (appelez UnloadDocument ou repassez Active à False). Passez AOwnsStream = True pour confier la propriété du flux à ce TPdf — l’adaptateur libère alors AStream lorsque UnloadDocument s’exécute. Passez False lorsque l’appelant veut garder le flux actif après la fermeture du document

LoadCustomDocument est volontairement une méthode séparée (et non une autre surcharge de LoadDocument) afin que les appelants passant une sous-classe de TMemoryStream ne puissent pas se lier accidentellement à la surcharge bufférisée LoadDocument(TMemoryStream, Boolean) — la forme des arguments Pascal est identique mais la sémantique est très différente (bufférisé vs à la demande)

La surcharge de politique applique le même comportement compatible, strict ou de récupération et le même audit borné des xref que ceux documentés par LoadDocument. L’audit utilise des lectures positionnées et restaure le curseur de la source avant que PDFium ne poursuive son accès à la demande

TPdfLoadOptions transporte Mode, AuditByteLimit, MaxIssues, MaxXrefSections, MaxXrefEntries, MaxObjectNumber, ValidateObjectOffsets et RequireFinalEndOfFileMarker, plus la fonction de classe Default

• Définissez Password avant d’appeler LoadCustomDocument lorsque vous ouvrez des documents chiffrés
• Le TPdf ne fait aucune supposition sur AStream — il peut s’agir d’un TFileStream, d’un TMemoryStream ou de toute sous-classe de TStream respectant Seek et Read
• PDFium lit répétitivement de petits blocs, si bien que des flux très lents (partages réseau, fichiers distants) se traduiront par des opérations de page sensiblement plus lentes qu’un LoadDocument bufférisé sur les mêmes données — choisissez en fonction de la pression mémoire par rapport à la latence
• Fermer ou libérer le flux AVANT que le TPdf ne le relâche produit un comportement indéfini au niveau de PDFium. En cas de doute, transférez la propriété avec AOwnsStream = True

LoadDocument, Active, Password, FileName