SaveAsOptionalContentConfigured - TPdf - PDFium Delphi Component

Komponente: TPdf · Unit: PDFium

Schreibt eine streng verifizierte PDF-Kopie, deren gewählte Optional-Content-Konfiguration den angeforderten nativen Rendering-Zustand erzeugt.

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

Die Methode führt das aktuelle Dokument durch PDFium, wendet jedes angeforderte Objektnummer-und-Sichtbarkeit-Paar auf die gewählte Konfiguration an, hängt die kleinste erforderliche Objekt- und Querverweis-Revision an und öffnet das Ergebnis dann durch strenge Validierung erneut, bevor es an das Aufruferziel kopiert wird

Die /ON- und /OFF-Arrays der Konfiguration werden für alle Gruppen geschrieben, und vorhandene OCG-Usage-Wörterbücher erhalten einen expliziten Zustand für Options.Usage, weil natives PDFium-Rendering diesen Werten Vorrang vor den Konfigurations-Arrays einräumt

TPdfOptionalContentConfigureOptions.Default wählt Konfiguration 0 und View-Nutzung, erzwingt Radio-Gruppen und entfernt Automatik-Zustandsregeln, die das angeforderte Ergebnis überschreiben könnten

Safety

Unbekannte Gruppenobjektnummern, Änderungen an gesperrten Gruppen und Radio-Gruppen mit mehr als einem sichtbaren Mitglied werden vor der Zielausgabe abgewiesen
Verschlüsselte zwischengespeicherte PDFs werden abgewiesen, weil Klartext-Inkrementalobjekte den aktiven Verschlüsselungs-Handler nicht bewahren können
Signierte Dokumente erfordern AllowSignedDocument=True, weil das Ändern sichtbarer Inhalte Signaturabdeckung oder -richtlinie ungültig machen kann
Die Datei-Überladung schreibt eine temporäre Datei und ersetzt das Ziel atomar erst nach erfolgreicher strenger Verifikation

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 Methode

Komponente: TPdf · Unit: PDFium

Syntax

Description

Safety

Example

See Also