SaveAs - TPdf - PDFium Delphi Component

Component: TPdf · Unit: PDFium

Slaat een kopie van het PDF-document op naar de opgegeven stream of het opgegeven bestand met expliciete PDF 1.3 tot PDF 1.7-normalisatie en conformiteitscontroles

Syntax

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

Stream	TStream-waarde die de PDF-gegevens ontvangt
Option	TSaveOption. Optie voor opslaan: `saNone` voor een normaal opslaan, `saIncremental` voor een incrementele update, `saNoIncremental` om een volledige herschrijving forceren, of `saRemoveSecurity` om beveiliging te verwijderen tijdens opslaan
PdfVersion	TPdfVersion-doel; gebruik `pvUnknown` om de huidige versie te behouden

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

FileName	string. Het uitvoerbestandspad. Een broeder-tijdelijk-bestand wordt eerst voltooid en vervolgens atomair de bestemming vervangen
Option	TSaveOption. Optie voor opslaan: `saNone`, `saIncremental`, `saNoIncremental` of `saRemoveSecurity`
PdfVersion	TPdfVersion-doel; gebruik `pvUnknown` om de huidige versie te behouden

Return Value

Retourneert True als het document succesvol is opgeslagen, of False bij mislukking

Description

Slaat het huidige document op naar een bestandspad of een TStream

De parameter PdfVersion specificeert de PDF-uitvoerversie; geef pvUnknown door om de bestaande versie van het document te behouden

De eigenschap Compressed bestuurt stroomcompressie. Hybrid-reference-, xref-stream- en object-stream-ingangen worden behouden wanneer een klassieke-xref-herschrijving hun volledige kruisverwijzingssemantiek niet kan behouden

Elke volledige (niet-incrementele) save repareert ToUnicode CMaps van subsetfonts waarvan de array-range-invoeren hun character mappings tegenspreken, zodat een opnieuw geladen document de originele spaties en koppeltekens extraheert in plaats van U+00A0 en U+00AD; incrementele revisies, sparse updates en cross-reference-stream-documenten gaan onveranderd door

Expliciete PDF-versiecontroles volgen de actieve kruisverwijzingsrevisieketen en actieve object-stream-leden, dus verouderde of niet-gerefereerde object-body's beïnvloeden de gevraagde versiepoort niet

De bestandsoverload laat een bestaande bestemming ongewijzigd als compressie, nabewerking of versievalidatie mislukt

De Windows V8-update van v3.125.2 herstelt de exacte persistentie van veldwaarden voor de geteste packet-arrays en de ondersteunde single-stream XDP-subset; oudere runtimes kunnen single-stream-bewerkingen verliezen of extra regeleinden introduceren

Open de XFA-uitvoer opnieuw en vergelijk de vereiste veldwaarden exact voordat je die accepteert; trim geen witruimte weg om een persistentieverschil te verbergen

Conformance behavior

pv13 normaliseert geërfde paginabronnen, canoniseert /ProcSet, en verwijdert alleen initiële transparantiestaat-waarden waaronder /BM /Normal, /SMask /None, /CA 1, /ca 1, /AIS false en /TK true
pv13 wijst actieve metagegevensstromen af omdat /Type /Metadata en XMP-componentmetagegevens PDF 1.4 of nieuwer vereisen
pv13 wijst document-/EmbeddedFiles-naambomen af met behoud van oudere ingebedde-bestand-stroomreferenties die de PDF 1.4-naamboomvermelding niet gebruiken
pv13 wijst de documentcatalogusvermelding /Lang af omdat documentniveau natuurlijk-taalidentificatie PDF 1.4 of nieuwer vereist
pv14 en oudere doelen wijzen documentcatalogus /PageLayout /TwoPageLeft en /TwoPageRight-waarden af omdat twee-pagina-lay-outs PDF 1.5 of nieuwer vereisen
pv14 en oudere doelen wijzen afbeelding-XObjects met /BitsPerComponent 16 af omdat 16-bit afbeeldingscomponenten PDF 1.5 of nieuwer vereisen
pv14 en oudere doelen wijzen afbeelding-XObject /SMaskInData-vermeldingen af omdat ingebedde JPEG 2000 soft-mask-kanalen PDF 1.5 of nieuwer vereisen
pv13 met saIncremental geeft EPdfError omdat normalisatie ondertekende eerdere revisies niet kan behouden
Elke versleutelde expliciete-versie-uitvoer geeft EPdfError; aanroepers moeten beveiliging verwijderen voordat ze een kernversiedoel aanvragen
Ontwikkelaarsextensie-woordenboeken worden onafhankelijk van de effectieve kernversie gevalideerd, inclusief escaped PDF-namen en strikte gehele niveaus
PRC 3D-stromen vereisen een /ADBE-ontwikkelaarsextensie met /BaseVersion /1.7 en /ExtensionLevel 1 of nieuwer; een kale PDF 1.7-declaratie is onvoldoende
RichMedia-annotaties en RichMediaExecute-acties vereisen een /ADBE-ontwikkelaarsextensie met /BaseVersion /1.7 en /ExtensionLevel 3 of nieuwer
Geospatiale /Type /Measure /Subtype /GEO-woordenboeken en Projection-annotaties vereisen een /ADBE-ontwikkelaarsextensie met /BaseVersion /1.7 en /ExtensionLevel 3 of nieuwer
Elk directe of indirecte annotatie-woordenboek bereikt via een Page /Annots-vermelding moet de vereiste vermeldingen /Subtype en /Rect bevatten
Catalogus /OCProperties-validatie vereist array /OCGs, woordenboek /D, geldige standaard /BaseState /ON- en /Intent /View-waarden indien aanwezig, en array-gewaardeerde /Configs-, /ON-, /OFF-, /AS- en /Order-vermeldingen
De Windows V8-bibliotheken van v3.125.2 behouden bewerkte XFA-tekst bij packet-array- en ondersteunde single-stream XDP-saves, inclusief lege tekst, oorspronkelijke witruimte, regeleinden en supplementary Unicode
De Windows V8-bibliotheken van v3.126.0 behouden XML-comments en processing instructions buiten de live datasets en form packets in ondersteunde single-stream XDP, inclusief UTF-8- en BOM-gemarkeerde UTF-16-invoer; comments en processing instructions binnen vervangen live packets, ongeldige UTF-8- of UTF-16-encoding, incomplete tags, ongeldige entity-referenties, misvormde processing instructions, DTD-declaraties en XMLDSig worden afgewezen voordat de persistente XFA-stream wordt gewijzigd
De Windows V8-bibliotheken van v3.126.2 wijzen ook misvormde attribuitspatiëring, niet-gequote waarden, lexicaal dubbele of via namespace-expansie dubbele attributen, ongebonden of gereserveerde namespace-prefixes, ongeldige qualified names, misplaatste declaraties, ongeldige declaratievolgorde en -waarden, en declaraties waarvan de encoding niet met de invoerbytes overeenkomt af voordat de persistente stream wordt gewijzigd
Deze begrensde XML 1.0-save-guards bieden geen schemavalidatie, DTD-ondersteuning, XMLDSig-herschrijving of algemene XML 1.1-ondersteuning; supplementary Unicode wordt ondersteund in tekst- en attribuutwaarden, terwijl element- en attribuutnamen beperkt blijven tot de BMP-naamondersteuning van de native DOM
Ondersteunde overige packet-elementen en root-namespaces worden semantisch behouden; de uitvoer gebruikt UTF-8 zonder byte-voor-byte XML-behoudsgarantie
De V8-bibliotheken van v3.125.2 rapporteren XFA-packet-exportfouten zonder de wijzigingsstatus te wissen; mislukte laatste gebufferde writers rapporteren in die V8-bibliotheken en in de gewone Windows-bibliotheken van v3.125.3 een mislukte save
Bestandsopslaan gebruiken een tijdelijk bestand in dezelfde map en vervangen de bestemming pas nadat nabewerking slaagt
Nabewerking met expliciete versie decodeert PNG-predictors die in de directe /DecodeParms-dictionary van de stream of in een parameterarray met één entry staan, ook predictorgecomprimeerde cross-reference streams in meerpagina-formulieren; ongerelateerde geneste keys overrulen de decoding-parameters van de stream niet

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 methode