LoadCustomDocument Método

LoadCustomDocument es la contrapartida de streaming de las sobrecargas almacenadas en búfer de LoadDocument. Está respaldada por el punto de entrada FPDF_LoadCustomDocument de PDFium a través de la clase auxiliar TPdfStreamAdapter introducida en v1.8.0 PDFium extrae bloques de AStream solo cuando se necesitan, de modo que el flujo no se copia en memoria: un TFileStream sobre un PDF de 4 GB, un TStream respaldado por HTTP o un flujo BLOB de base de datos se vuelven utilizables sin preparar antes toda la carga en RAM.

AStream debe admitir posicionamiento. Su vida útil debe extenderse hasta que el documento se cierre (llame a UnloadDocument o restablezca Active a False). Pase AOwnsStream = True para transferir la propiedad del flujo a este TPdf — el adaptador entonces libera AStream cuando se ejecuta UnloadDocument. Pase False cuando el llamador quiera mantener el flujo vivo tras cerrar el documento.

LoadCustomDocument es deliberadamente un método separado (no otra sobrecarga de LoadDocument) para que los llamadores que pasan una subclase de TMemoryStream no se enlacen accidentalmente a la sobrecarga almacenada en búfer LoadDocument(TMemoryStream, Boolean) — la forma del argumento Pascal es idéntica, pero la semántica es muy distinta (en búfer frente a bajo demanda).

• Establezca Password antes de llamar a LoadCustomDocument al abrir documentos cifrados.
• El TPdf no asume 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 libera produce un comportamiento indefinido a nivel de PDFium. En caso de duda, transfiera la propiedad con AOwnsStream = True.