SaveAs - TPdf - PDFium Delphi Component

Composant: TPdf · Unit: PDFium

Sauvegarde une copie du document PDF vers le flux ou fichier spécifié avec une normalisation PDF 1.3 à PDF 1.7 explicite et des vérifications de conformité

Syntax

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

Stream	Valeur TStream qui reçoit les données PDF
Option	TSaveOption. Option de sauvegarde : `saNone` pour une sauvegarde normale, `saIncremental` pour une mise à jour incrémentale, `saNoIncremental` pour forcer une réécriture complète, ou `saRemoveSecurity` pour supprimer la sécurité pendant la sauvegarde
PdfVersion	Cible TPdfVersion ; utilisez `pvUnknown` pour préserver la version courante

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

FileName	string. Le chemin de fichier de sortie. Un fichier temporaire frère est terminé d’abord, puis remplace atomiquement la destination
Option	TSaveOption. Save option: `saNone`, `saIncremental`, `saNoIncremental`, or `saRemoveSecurity`
PdfVersion	Cible TPdfVersion ; utilisez `pvUnknown` pour préserver la version courante

Return Value

Renvoie True si le document a été sauvegardé avec succès, ou False en cas d’échec

Description

Sauvegarde le document courant vers un chemin de fichier ou un TStream

Le paramètre PdfVersion spécifie la version PDF de sortie ; passez pvUnknown pour garder la version existante du document

La propriété Compressed contrôle la compression des flux. Les entrées à référence hybride, flux xref et flux d’objet sont préservées lorsqu’une réécriture à xref classique ne peut pas retenir leur sémantique de références croisées complète

Chaque sauvegarde complète (non incrémentale) répare les CMap ToUnicode des polices subset dont les éléments de plage de tableau contredisent leurs mappages de caractères, si bien qu’un document rechargé extrait les espaces et traits d’union d’origine au lieu de U+00A0 et U+00AD ; les révisions incrémentales, les mises à jour éparses et les documents à flux de références croisées passent sans modification

Les vérifications de version PDF explicites suivent la chaîne de révision de références croisées active et les membres de flux d’objet actifs, afin que les corps d’objet périmés ou non référencés n’affectent pas la porte de version demandée

La surcharge fichier laisse une destination existante inchangée si la compression, le post-traitement ou la validation de version échoue

La mise à jour V8 de Windows v3.125.2 répare la persistance exacte des valeurs de champs pour les tableaux de paquets testés et le sous-ensemble XDP monoflux pris en charge ; les runtimes plus anciens peuvent perdre des éditions monoflux ou introduire des sauts de ligne supplémentaires

Rouvrez la sortie XFA et comparez exactement les valeurs de champ requises avant de l’accepter ; ne supprimez pas les espaces pour masquer une différence de persistance

Conformance behavior

pv13 normalise les ressources de page héritées, canonise /ProcSet et ne supprime que les valeurs d’état de transparence initiales, y compris /BM /Normal, /SMask /None, /CA 1, /ca 1, /AIS false et /TK true
pv13 rejette les flux de métadonnées actifs car /Type /Metadata et les métadonnées de composant XMP requièrent PDF 1.4 ou plus récent
pv13 rejette les arbres de noms /EmbeddedFiles du document tout en conservant les anciennes références de flux de fichier intégré qui n’utilisent pas l’entrée d’arbre de noms PDF 1.4
pv13 rejette l’entrée /Lang du catalogue de document car l’identification de langue naturelle au niveau document requiert PDF 1.4 ou plus récent
pv14 et les cibles plus anciennes rejettent les valeurs /PageLayout /TwoPageLeft et /TwoPageRight du catalogue de document car les dispositions à deux pages requièrent PDF 1.5 ou plus récent
pv14 et les cibles plus anciennes rejettent les XObjects d’image avec /BitsPerComponent 16 car les composants d’image 16 bits requièrent PDF 1.5 ou plus récent
pv14 et les cibles plus anciennes rejettent les entrées /SMaskInData d’XObject d’image car les canaux de masque doux JPEG 2000 intégrés requièrent PDF 1.5 ou plus récent
pv13 avec saIncremental lève EPdfError car la normalisation ne peut pas préserver les révisions antérieures signées
Toute sortie à version explicite chiffrée lève EPdfError ; les appelants doivent supprimer la sécurité avant de demander une cible de version de cœur
Les dictionnaires d’extension développeur sont validés indépendamment de la version de cœur effective, y compris les noms PDF échappés et les niveaux entiers stricts
Les flux PRC 3D exigent une extension développeur /ADBE avec /BaseVersion /1.7 et /ExtensionLevel 1 ou plus récent ; une simple déclaration PDF 1.7 est insuffisante
Les annotations RichMedia et les actions RichMediaExecute exigent une extension développeur /ADBE avec /BaseVersion /1.7 et /ExtensionLevel 3 ou plus récent
Les dictionnaires géospatiaux /Type /Measure /Subtype /GEO et les annotations Projection exigent une extension développeur /ADBE avec /BaseVersion /1.7 et /ExtensionLevel 3 ou plus récent
Chaque dictionnaire d’annotation direct ou indirect atteint via une entrée Page /Annots doit contenir les entrées requises /Subtype et /Rect
La validation de /OCProperties du catalogue exige un tableau /OCGs, un dictionnaire /D, des valeurs par défaut valides /BaseState /ON et /Intent /View lorsqu’elles sont présentes, et des entrées à valeur tableau /Configs, /ON, /OFF, /AS et /Order
Les bibliothèques V8 de Windows v3.125.2 préservent le texte XFA édité à travers les enregistrements par tableau de paquets et le XDP monoflux pris en charge, y compris le texte vide, les blancs d’origine, les sauts de ligne et les caractères Unicode supplémentaires
Les bibliothèques V8 de Windows v3.126.0 préservent les commentaires XML et les instructions de traitement hors des datasets vivants et des paquets de formulaire dans le XDP monoflux pris en charge, y compris les entrées UTF-8 et UTF-16 marquées par un BOM ; les commentaires et instructions de traitement à l’intérieur des paquets vivants remplacés, les encodages UTF-8 ou UTF-16 invalides, les balises incomplètes, les références d’entité invalides, les instructions de traitement mal formées, les déclarations DTD et XMLDSig sont rejetés avant de modifier le flux XFA persistant
Les bibliothèques V8 de Windows v3.126.2 rejettent aussi l’espacement d’attributs mal formé, les valeurs non quotées, les attributs lexicaux ou étendus par espace de noms dupliqués, les préfixes d’espace de noms non liés ou réservés, les noms qualifiés invalides, les déclarations mal placées, l’ordre et les valeurs de déclaration invalides, et les déclarations dont l’encodage ne correspond pas aux octets d’entrée, avant de modifier le flux persistant
Ces garde-fous d’enregistrement XML 1.0 bornés n’apportent ni validation de schéma, ni prise en charge des DTD, ni réécriture XMLDSig, ni prise en charge générale de XML 1.1 ; l’Unicode supplémentaire est pris en charge dans les valeurs de texte et d’attribut, tandis que les noms d’éléments et d’attributs restent limités à la prise en charge BMP des noms du DOM natif
Les autres éléments de paquets pris en charge et les espaces de noms racine sont conservés sémantiquement ; la sortie utilise UTF-8 sans garantie de préservation XML octet par octet
Les bibliothèques V8 v3.125.2 rapportent les échecs d’exportation de paquets XFA sans effacer l’état de modification ; les échecs de l’écrivain final mis en mémoire tampon sont signalés comme échecs d’enregistrement dans ces bibliothèques V8 et dans les bibliothèques Windows ordinaires v3.125.3
Les sauvegardes de fichier utilisent un fichier temporaire dans le même répertoire et ne remplacent la destination qu’après la réussite du post-traitement
Le post-traitement à version explicite décode les prédicteurs PNG déclarés dans le dictionnaire /DecodeParms direct du flux ou dans son tableau de paramètres à entrée unique, y compris les flux de références croisées compressés par prédicteur dans les formulaires multipages ; les clés imbriquées sans rapport ne remplacent pas les paramètres de décodage du flux

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 Méthode