LoadCustomDocument Metodo

Carica un PDF da qualsiasi TStream seekable tramite il lettore a blocchi on-demand di PDFium, così i documenti di più GB e le sorgenti remote o basate su database non richiedono una copia anticipata in memoria

LoadCustomDocument è la controparte in streaming degli overload bufferizzati di LoadDocument. È basato sul punto di ingresso FPDF_LoadCustomDocument di PDFium tramite la classe helper TPdfStreamAdapter introdotta nella v1.8.0. PDFium preleva blocchi da AStream solo quando necessario, quindi lo stream non viene copiato in memoria: un TFileStream su un PDF da 4 GB, un TStream supportato da HTTP o uno stream BLOB di database diventano tutti utilizzabili senza staging dell'intero payload in RAM

AStream deve supportare il posizionamento (seek). La sua durata deve estendersi fino alla chiusura del documento (chiamare UnloadDocument o riportare Active a False). Passare AOwnsStream = True per trasferire la proprietà dello stream a questo TPdf — l'adattatore libera quindi AStream quando UnloadDocument viene eseguito. Passare False quando il chiamante vuole mantenere lo stream attivo dopo la chiusura del documento

LoadCustomDocument è volutamente un metodo separato (non un altro overload di LoadDocument) così i chiamanti che passano una sottoclasse di TMemoryStream non possono collegarsi per errore all'overload bufferizzato LoadDocument(TMemoryStream, Boolean) — la forma degli argomenti Pascal è identica ma la semantica è molto diversa (bufferizzato rispetto a on-demand)

L'overload con criteri applica lo stesso comportamento compatible, strict o recovery e la stessa verifica xref delimitata documentati da LoadDocument. La verifica usa letture posizionali e ripristina il cursore della sorgente prima che PDFium continui il suo accesso on-demand

TPdfLoadOptions contiene Mode, AuditByteLimit, MaxIssues, MaxXrefSections, MaxXrefEntries, MaxObjectNumber, ValidateObjectOffsets e RequireFinalEndOfFileMarker, oltre alla funzione di classe Default

• Impostare Password prima di chiamare LoadCustomDocument quando si aprono documenti cifrati
• Il TPdf non fa alcuna ipotesi su AStream — può essere un TFileStream, un TMemoryStream o qualsiasi sottoclasse di TStream che onori Seek e Read
• PDFium legge piccoli blocchi ripetutamente, quindi stream molto lenti (condivisioni di rete, file remoti) si traducono in operazioni di pagina notevolmente più lente rispetto a un LoadDocument bufferizzato sugli stessi dati — scegliere in base alla pressione di memoria rispetto alla latenza
• Chiudere o liberare lo stream PRIMA che il TPdf lo rilasci produce un comportamento indefinito a livello PDFium. In caso di dubbio, trasferire la proprietà con AOwnsStream = True

LoadDocument, Active, Password, FileName