SaveAsOptionalContentConfigured - TPdf - PDFium Delphi Component

Componente: TPdf · Unidade: PDFium

Grava uma cópia de PDF estritamente verificada cuja configuração de conteúdo opcional selecionada produz o estado de renderização nativo solicitado

Syntax

function SaveAsOptionalContentConfigured(Stream: TStream;
  const Changes: TPdfOptionalContentStateChanges;
  const Options: TPdfOptionalContentConfigureOptions;
  out Report: TPdfOptionalContentConfigureReport;
  AllowSignedDocument: Boolean = False): Boolean; overload;

function SaveAsOptionalContentConfigured(const FileName: string;
  const Changes: TPdfOptionalContentStateChanges;
  const Options: TPdfOptionalContentConfigureOptions;
  out Report: TPdfOptionalContentConfigureReport;
  AllowSignedDocument: Boolean = False): Boolean; overload;

Description

O método prepara o documento atual por meio do PDFium, aplica cada par de número de objeto e visibilidade solicitado à configuração selecionada, anexa a menor revisão necessária de objetos e tabela de referência cruzada, então reabre o resultado por validação estrita antes de copiá-lo para o destino do chamador

Os arrays /ON e /OFF da configuração são gravados para todos os grupos, e os dicionários Usage de OCG existentes recebem um estado explícito para Options.Usage, porque a renderização nativa do PDFium dá a esses valores precedência sobre os arrays de configuração

O TPdfOptionalContentConfigureOptions.Default seleciona a configuração 0 e o uso View, impõe grupos de opção única e remove regras de estado automático que poderiam substituir o resultado solicitado

Safety

Números de objeto de grupo desconhecidos, mudanças em grupos bloqueados e grupos de opção única com mais de um membro visível são rejeitados antes da saída no destino
PDFs preparados criptografados são rejeitados porque objetos incrementais em texto puro não podem preservar o manipulador de criptografia ativo
Documentos assinados exigem AllowSignedDocument=True porque alterar o conteúdo visível pode invalidar a cobertura ou a política de assinatura
A sobrecarga de arquivo grava um arquivo temporário e substitui o destino atomicamente somente depois que a verificação estrita é bem-sucedida

Example

var
  Changes: TPdfOptionalContentStateChanges;
  Options: TPdfOptionalContentConfigureOptions;
  Report: TPdfOptionalContentConfigureReport;
begin
  SetLength(Changes, 1);
  Changes[0].GroupObjectNumber := 12;
  Changes[0].Visible := False;
  Options := TPdfOptionalContentConfigureOptions.Default;
  Pdf1.SaveAsOptionalContentConfigured('C:\Layers.pdf', Changes, Options, Report);
end;

SaveAsOptionalContentConfigured Método

Componente: TPdf · Unidade: PDFium

Syntax

Description

Safety

Example

See Also