PDFium Delphi Component Docs

SaveAsPdfUa-metodi

Komponentti: TPdf  ·  Yksikkö: PDFium
Tallentaa oletuksena PDF/UA-1:n tai PDF/UA-2:n, kun se on määritetty TPdfUaSaveOptions.PdfUa2-asetuksella

Syntax

function SaveAsPdfUa(const FileName: string): Boolean; overload;
function SaveAsPdfUa(const FileName: string; const Options: TPdfUaSaveOptions): Boolean; overload;

Description

SaveAsPdfUa suorittaa ensin tavallisen SaveAs-kutsun ja lisää sitten tallennettujen tavujen päälle inkrementaalisen päivityksen, joka nostaa tiedoston PDF/UA-1- tai PDF/UA-2-dokumentiksi. Jälkikäsittely ruiskuttaa tallennettuun virtaan neljä luokkaa merkintöjä:

Tuloste pysyy tavutasolla identtisenä perus-SaveAs-tulokseen alkuperäisen PDF:n loppuun asti; liitetään vain inkrementaalinen päivitys. Olemassa olevat lukijat, jotka eivät tunne PDF/UA:ta, renderöivät tiedoston täsmälleen samoin kuin tavallinen SaveAs. Kaksi ylikuormitusta eroaa vain konfiguraation välitystavasta: pelkkä tiedostonimi -muoto käyttää TPdfUaSaveOptions.Default-asetusta automaattisella täydöllä FPDF_GetMetaText / FPDF_GetFileIdentifier / FPDFCatalog_GetLanguage-kutsuista, kun taas TPdfUaSaveOptions-muoto antaa kutsujan ohittaa Title-, Author-, Subject-, Keywords-, Creator-, Producer-, CreationDate-, ModDate-, Language- ja DocumentId-arvot, InstanceId:n sekä pdfuaid-tunnusten Part-, Revision-, Amd- ja Corr-arvot

TPdfUaSaveOptions.PdfUa2 valitsee osan 2, toimittaa oletusarvon pdfuaid:rev = 2024 ja kirjoittaa katalogiin /Version /2.0, jolloin inkrementaalisesti päivitetyn PDF 1.x -lähteen tehokas versio on PDF 2.0

Palauttaa arvon True onnistuessaan. Palauttaa arvon False, jos perus-SaveAs epäonnistui tai jos inkrementaalista päivitystä ei voitu liittää (PDF liian lyhyt, virheellinen trailer, salattu lähde)

Remarks

Example

// Simple PDF/UA-1 output, options auto-populated from the document
if Pdf1.SaveAsPdfUa('C:\Report.pdfua.pdf') then
  ShowMessage('Saved PDF/UA-1');

// With explicit options (Title overridden, language explicit)
var
  Opts: TPdfUaSaveOptions;
begin
  Opts := TPdfUaSaveOptions.Default;
  Opts.DocumentTitle := 'Quarterly Report Q3 2026';
  Opts.Language := 'en-US';
  Pdf1.SaveAsPdfUa('C:\Report.q3.pdfua.pdf', Opts);

// PDF/UA-2 output based on ISO 32000-2
  Opts := TPdfUaSaveOptions.PdfUa2;
  Opts.DocumentTitle := 'Accessible PDF 2.0 report';
  Opts.Language := 'en-US';
  Pdf1.SaveAsPdfUa('C:\Report.pdfua2.pdf', Opts);
end;

See Also

SaveAsPdfUaToStream, ValidatePdfUa, PdfUaConformance, SaveAsPdfA, IsTagged