LoadCustomDocument método

Carrega um PDF de qualquer TStream com capacidade de busca usando o leitor de blocos sob demanda do PDFium, de modo que documentos de vários GB e fontes remotas ou de banco de dados não precisam de uma cópia antecipada em memória

LoadCustomDocument é a contraparte em streaming das sobrecargas LoadDocument em buffer. Ele é implementado sobre o ponto de entrada FPDF_LoadCustomDocument do PDFium por meio da classe auxiliar TPdfStreamAdapter introduzida na v1.8.0. O PDFium puxa blocos de AStream apenas quando necessário, de modo que o stream não é copiado para a memória: um TFileStream sobre um PDF de 4 GB, um TStream sobre HTTP ou um stream de BLOB de banco de dados tornam-se utilizáveis sem estagiar todo o conteúdo na RAM primeiro

O AStream deve suportar busca (seek). Seu tempo de vida deve se estender até que o documento seja fechado (chame UnloadDocument ou retorne Active para False). Passe AOwnsStream = True para transferir a propriedade do stream para este TPdf — o adaptador então libera AStream quando UnloadDocument é executado. Passe False quando quem chama quiser manter o stream vivo depois que o documento fechar

LoadCustomDocument é intencionalmente um método separado (não outra sobrecarga de LoadDocument) para que quem chama passando uma subclasse de TMemoryStream não se vincule acidentalmente à sobrecarga em buffer LoadDocument(TMemoryStream, Boolean) — a forma dos argumentos Pascal é idêntica, mas a semântica é muito diferente (em buffer vs. sob demanda)

A sobrecarga com políticas aplica o mesmo comportamento compatível, estrito ou de recuperação e a mesma auditoria limitada de xref documentada por LoadDocument. A auditoria usa leituras posicionadas e restaura o cursor da origem antes que o PDFium continue seu acesso sob demanda

TPdfLoadOptions carrega Mode, AuditByteLimit, MaxIssues, MaxXrefSections, MaxXrefEntries, MaxObjectNumber, ValidateObjectOffsets e RequireFinalEndOfFileMarker, além da função de classe Default

• Defina Password antes de chamar LoadCustomDocument ao abrir documentos criptografados
• O TPdf não assume nada sobre o AStream — ele pode ser um TFileStream, um TMemoryStream ou qualquer subclasse de TStream que honre Seek e Read
• O PDFium lê pequenos blocos repetidamente, então streams muito lentos (compartilhamentos de rede, arquivos remotos) se traduzirão em operações de página notavelmente mais lentas do que um LoadDocument em buffer sobre os mesmos dados — escolha com base na pressão de memória versus latência
• Fechar ou liberar o stream ANTES de o TPdf liberá-lo produz comportamento indefinido no nível do PDFium. Em caso de dúvida, transfira a propriedade com AOwnsStream = True

LoadDocument, Active, Password, FileName