LoadCustomDocument Método

Carga un PDF desde cualquier TStream que admita búsqueda usando el lector de bloques bajo demanda de PDFium, de modo que los documentos de varios GB y las fuentes remotas o respaldadas por bases de datos no necesitan una copia previa en memoria

LoadCustomDocument es la contraparte de transmisión por flujo de las sobrecargas almacenadas en búfer de LoadDocument. Se apoya en el punto de entrada FPDF_LoadCustomDocument de PDFium mediante la clase auxiliar TPdfStreamAdapter introducida en v1.8.0. PDFium extrae bloques de AStream solo cuando los necesita, de modo que el flujo no se copia a memoria: un TFileStream sobre un PDF de 4 GB, un TStream respaldado por HTTP o un flujo de BLOB de base de datos se vuelven utilizables sin cargar primero toda la carga útil en RAM

AStream debe admitir búsqueda. Su tiempo de vida debe extenderse hasta que el documento se cierre (llame a UnloadDocument o devuelva Active a False). Pase AOwnsStream = True para transferir a este TPdf la propiedad del flujo — el adaptador entonces libera AStream cuando se ejecuta UnloadDocument. Pase False cuando quien llama quiera mantener el flujo vivo después de cerrar el documento

LoadCustomDocument es intencionalmente un método separado (no otra sobrecarga de LoadDocument) para que quienes pasan una subclase de TMemoryStream no puedan enlazarse por accidente a la sobrecarga almacenada en búfer LoadDocument(TMemoryStream, Boolean) — la forma de los argumentos Pascal es idéntica, pero la semántica es muy distinta (almacenado en búfer frente a bajo demanda)

La sobrecarga con políticas aplica el mismo comportamiento compatible, estricto o de recuperación y la auditoría acotada de xref documentados por LoadDocument. La auditoría usa lecturas posicionadas y restaura el cursor de la fuente antes de que PDFium continúe su acceso bajo demanda

TPdfLoadOptions lleva Mode, AuditByteLimit, MaxIssues, MaxXrefSections, MaxXrefEntries, MaxObjectNumber, ValidateObjectOffsets y RequireFinalEndOfFileMarker, además de la función de clase Default

• Establezca Password antes de llamar a LoadCustomDocument cuando abra documentos cifrados
• El TPdf no supone nada sobre AStream — puede ser un TFileStream, un TMemoryStream o cualquier subclase de TStream que respete Seek y Read
• PDFium lee fragmentos pequeños repetidamente, de modo que los flujos muy lentos (recursos compartidos de red, archivos remotos) se traducirán en operaciones de página notablemente más lentas que un LoadDocument almacenado en búfer sobre los mismos datos — elija según la presión de memoria frente a la latencia
• Cerrar o liberar el flujo ANTES de que el TPdf lo libere produce un comportamiento indefinido a nivel de PDFium. Ante la duda, transfiera la propiedad con AOwnsStream = True

LoadDocument, Active, Password, FileName