SaveAs - TPdf - PDFium Delphi Component

Componente: TPdf · Unità: PDFium

Salva una copia del documento PDF nello stream o nel file specificati con normalizzazione e controlli di conformità espliciti da PDF 1.3 a PDF 1.7

Syntax

function SaveAs(Stream: TStream; Option: TSaveOption = saNone; PdfVersion: TPdfVersion = pvUnknown): Boolean;

Stream	Valore TStream che riceve i dati PDF
Option	TSaveOption. Opzione di salvataggio: `saNone` per un salvataggio normale, `saIncremental` per un aggiornamento incrementale, `saNoIncremental` per forzare una riscrittura completa o `saRemoveSecurity` per rimuovere la protezione durante il salvataggio
PdfVersion	Destinazione TPdfVersion; usare `pvUnknown` per preservare la versione corrente

function SaveAs(const FileName: string; Option: TSaveOption = saNone; PdfVersion: TPdfVersion = pvUnknown): Boolean;

FileName	string. Percorso del file di output. Un file temporaneo adiacente viene completato per primo, poi sostituisce atomicamente la destinazione
Option	TSaveOption. Opzione di salvataggio: `saNone`, `saIncremental`, `saNoIncremental` o `saRemoveSecurity`
PdfVersion	Destinazione TPdfVersion; usare `pvUnknown` per preservare la versione corrente

Return Value

Restituisce True se il documento è stato salvato con successo, oppure False in caso di fallimento

Description

Salva il documento corrente su un percorso file o un TStream

Il parametro PdfVersion specifica la versione PDF di output; passare pvUnknown per mantenere la versione esistente del documento

La proprietà Compressed controlla la compressione degli stream. Gli input a riferimenti ibridi, xref-stream e object-stream vengono preservati quando una riscrittura con xref classico non può conservarne la semantica completa di riferimenti incrociati

Ogni salvataggio completo (non incrementale) ripara i ToUnicode CMap dei font subset le cui voci di intervallo di array contraddicono le loro mappature di caratteri, così un documento ricaricato estrae gli spazi e i trattini originali invece di U+00A0 e U+00AD; le revisioni incrementali, gli aggiornamenti sparse e i documenti con cross-reference stream passano invariati

I controlli espliciti della versione PDF seguono la catena di revisioni del riferimento incrociato attivo e i membri attivi degli object-stream, quindi i corpi degli oggetti obsoleti o non referenziati non influenzano il controllo della versione richiesta

L'overload su file lascia invariata una destinazione esistente se la compressione, la post-elaborazione o la validazione della versione fallisce

L'aggiornamento V8 Windows della v3.125.2 ripara la persistenza esatta dei valori dei campi per gli array di pacchetti testati e per il sottoinsieme XDP single-stream supportato; i runtime più vecchi possono scartare le modifiche single-stream o introdurre newline extra

Riaprire l'output XFA e confrontare esattamente i valori dei campi richiesti prima di accettarlo; non fare trim degli spazi per nascondere una differenza di persistenza

Conformance behavior

pv13 normalizza le risorse di pagina ereditate, canonizza /ProcSet e rimuove solo i valori iniziali dello stato di trasparenza, inclusi /BM /Normal, /SMask /None, /CA 1, /ca 1, /AIS false e /TK true
pv13 rifiuta gli stream di metadati attivi perché /Type /Metadata e i metadati dei componenti XMP richiedono PDF 1.4 o successivo
pv13 rifiuta gli alberi di nomi /EmbeddedFiles del documento mantenendo i riferimenti a stream di file incorporati più vecchi che non usano la voce dell'albero di nomi di PDF 1.4
pv13 rifiuta la voce /Lang del catalogo del documento perché l'identificazione della lingua naturale a livello di documento richiede PDF 1.4 o successivo
Le destinazioni pv14 e precedenti rifiutano i valori /PageLayout /TwoPageLeft e /TwoPageRight del catalogo del documento perché i layout a due pagine richiedono PDF 1.5 o successivo
Le destinazioni pv14 e precedenti rifiutano gli XObject immagine con /BitsPerComponent 16 perché i componenti immagine a 16 bit richiedono PDF 1.5 o successivo
Le destinazioni pv14 e precedenti rifiutano le voci /SMaskInData degli XObject immagine perché i canali soft-mask JPEG 2000 incorporati richiedono PDF 1.5 o successivo
pv13 con saIncremental genera EPdfError perché la normalizzazione non può preservare le revisioni precedenti firmate
Qualsiasi output cifrato con versione esplicita genera EPdfError; i chiamanti devono rimuovere la protezione prima di richiedere una destinazione a versione core
I dizionari di estensione per sviluppatori vengono validati indipendentemente dalla versione core effettiva, inclusi i nomi PDF con escape e i livelli interi rigorosi
Gli stream 3D PRC richiedono un'estensione per sviluppatori /ADBE con /BaseVersion /1.7 e /ExtensionLevel 1 o successivo; una semplice dichiarazione PDF 1.7 non è sufficiente
Le annotazioni RichMedia e le azioni RichMediaExecute richiedono un'estensione per sviluppatori /ADBE con /BaseVersion /1.7 e /ExtensionLevel 3 o successivo
I dizionari geospaziali /Type /Measure /Subtype /GEO e le annotazioni Projection richiedono un'estensione per sviluppatori /ADBE con /BaseVersion /1.7 e /ExtensionLevel 3 o successivo
Ogni dizionario di annotazione, diretto o indiretto, raggiunto tramite una voce /Annots della pagina deve contenere le voci richieste /Subtype e /Rect
La validazione di /OCProperties del catalogo richiede l'array /OCGs, il dizionario /D, valori predefiniti validi /BaseState /ON e /Intent /View quando presenti, e le voci a valore di array /Configs, /ON, /OFF, /AS e /Order
Le librerie V8 Windows della v3.125.2 preservano il testo XFA modificato attraverso i salvataggi con array di pacchetti e XDP single-stream supportato, incluso testo vuoto, spazi originali, interruzioni di riga e Unicode supplementary
Le librerie V8 Windows della v3.126.0 preservano i commenti XML e le processing instruction fuori dai dataset live e dai pacchetti del modulo nello XDP single-stream supportato, inclusi input UTF-8 e UTF-16 con BOM; commenti e processing instruction dentro i pacchetti live sostituiti, codifiche UTF-8 o UTF-16 non valide, tag incompleti, riferimenti a entità non validi, processing instruction malformate, dichiarazioni DTD e XMLDSig vengono rifiutati prima di modificare lo stream XFA persistente
Le librerie V8 Windows della v3.126.2 rifiutano anche spaziatura degli attributi malformata, valori senza virgolette, attributi duplicati lessicalmente o dopo espansione dei namespace, prefissi di namespace non vincolati o riservati, qualified name non validi, dichiarazioni fuori posto, ordine e valori di dichiarazione non validi e dichiarazioni la cui codifica non corrisponde ai byte di input, prima di modificare lo stream persistente
Queste protezioni di salvataggio limitate a XML 1.0 non forniscono validazione schema, supporto DTD, riscrittura XMLDSig o supporto generale di XML 1.1; lo Unicode supplementary è supportato nei valori di testo e attributo, mentre i nomi di elementi e attributi restano limitati al supporto BMP dei nomi del DOM nativo
Gli altri elementi dei pacchetti supportati e i namespace radice vengono conservati semanticamente; l'output usa UTF-8 senza garanzia di preservazione XML byte per byte
Le librerie V8 della v3.125.2 riportano i fallimenti di esportazione dei pacchetti XFA senza azzerare lo stato di modifica; i fallimenti del writer finale bufferizzato riportano salvataggi falliti in quelle librerie V8 e nelle librerie ordinarie Windows della v3.125.3
I salvataggi su file usano un file temporaneo nella stessa directory e sostituiscono la destinazione solo dopo che la post-elaborazione riesce
La post-elaborazione a versione esplicita decodifica i predictor PNG dichiarati nel dizionario diretto /DecodeParms dello stream o nel suo array di parametri a voce singola, compresi gli stream di riferimenti incrociati compressi con predictor nei moduli multipagina; chiavi annidate non correlate non sostituiscono i parametri di decodifica dello stream

Example

// Save to file
Pdf.SaveAs('output.pdf');

// Save to stream
var MS: TMemoryStream;
MS := TMemoryStream.Create;
try
  Pdf.SaveAs(MS);
  MS.SaveToFile('output.pdf');
finally
  MS.Free;
end;

SaveAs Metodo