SaveAs - TPdf - PDFiumPas

Component: TPdf · Unit: PDFium

Zapisuje kopię dokumentu PDF do określonego strumienia lub pliku z jawną normalizacją od PDF 1.3 do PDF 1.7 i sprawdzaniem zgodności

Syntax

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

Stream	Wartość TStream, która odbiera dane PDF
Option	TSaveOption. Opcja zapisu: `saNone` dla normalnego zapisu, `saIncremental` dla aktualizacji przyrostowej, `saNoIncremental` aby wymusić pełny przepis, lub `saRemoveSecurity`, aby usunąć zabezpieczenia podczas zapisu
PdfVersion	Wersja docelowa TPdfVersion; użyj `pvUnknown`, aby zachować bieżącą wersję

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

FileName	string. Docelowa ścieżka pliku wyjściowego. Najpierw tworzony jest plik tymczasowy w tym samym katalogu, a następnie niepodzielnie zastępuje miejsce docelowe
Option	TSaveOption. Opcja zapisu: `saNone`, `saIncremental`, `saNoIncremental` lub `saRemoveSecurity`
PdfVersion	Wersja docelowa TPdfVersion; użyj `pvUnknown`, aby zachować bieżącą wersję

Return Value

Zwraca True, jeśli dokument został pomyślnie zapisany, lub False w przypadku niepowodzenia

Description

Zapisuje bieżący dokument do ścieżki pliku lub strumienia TStream

Parametr PdfVersion określa wyjściową wersję PDF; przekaż pvUnknown, aby zachować istniejącą wersję dokumentu

Właściwość Compressed steruje kompresją strumienia. Dane wejściowe hybrydowego odwzorowania, strumienia xref i strumienia obiektów są zachowywane, gdy przepis klasycznego xref nie może zachować ich pełnej semantyki odsyłaczy krzyżowych

Jawne sprawdzenia wersji PDF podążają za aktywnym łańcuchem rewizji odsyłaczy krzyżowych i aktywnymi składowymi strumienia obiektów, więc nieaktualne lub nieodwoływane treści obiektów nie wpływają na żądane bramkowanie wersji

Przeciążenie pliku pozostawia istniejące miejsce docelowe niezmienione, jeśli kompresja, przetwarzanie końcowe lub walidacja wersji zawiedzie

Conformance behaviour

pv13 normalizuje dziedziczone zasoby stron, kanonizuje /ProcSet i usuwa tylko początkowe wartości stanu przezroczystości, w tym /BM /Normal, /SMask /None, /CA 1, /ca 1, /AIS false oraz /TK true
pv13 odrzuca aktywne strumienie metadanych, ponieważ /Type /Metadata i metadane składnika XMP wymagają wersji PDF 1.4 lub nowszej
pv13 odrzuca drzewa nazw /EmbeddedFiles dokumentu, zachowując jednocześnie starsze odwołania do strumieni osadzonych plików, które nie używają wpisu drzewa nazw PDF 1.4
pv13 odrzuca wpis /Lang katalogu dokumentu, ponieważ identyfikacja języka naturalnego na poziomie dokumentu wymaga wersji PDF 1.4 lub nowszej
pv14 i starsze cele odrzucają wartości /PageLayout /TwoPageLeft i /TwoPageRight katalogu dokumentu, ponieważ układy dwustronicowe wymagają wersji PDF 1.5 lub nowszej
pv14 i starsze cele odrzucają obiekty XObject obrazów z /BitsPerComponent 16, ponieważ 16-bitowe składniki obrazu wymagają wersji PDF 1.5 lub nowszej
pv14 i starsze cele odrzucają wpisy /SMaskInData obiektów XObject obrazów, ponieważ osadzone kanały miękkiej maski JPEG 2000 wymagają wersji PDF 1.5 lub nowszej
pv13 z saIncremental zgłasza EPdfError, ponieważ normalizacja nie może zachować podpisanych wcześniejszych rewizji
Każde zaszyfrowane wyjście z jawną wersją zgłasza EPdfError; wywołujący muszą usunąć zabezpieczenia przed zażądaniem celu wersji podstawowej
Słowniki rozszerzeń deweloperskich są walidowane niezależnie od efectywnej wersji podstawowej, w tym o zmienionym znaczeniu nazwy PDF i ścisłych poziomach liczb całkowitych
Strumienie 3D PRC wymagają rozszerzenia deweloperskiego /ADBE z /BaseVersion /1.7 i /ExtensionLevel 1 lub nowszym; sama deklaracja PDF 1.7 jest niewystarczająca
Adnotacje RichMedia i akcje RichMediaExecute wymagają rozszerzenia deweloperskiego /ADBE z /BaseVersion /1.7 i /ExtensionLevel 3 lub nowszym
Słowniki geoprzestrzenne /Type /Measure /Subtype /GEO i adnotacje Projection wymagają rozszerzenia deweloperskiego /ADBE z /BaseVersion /1.7 i /ExtensionLevel 3 lub nowszym
Każdy bezpośredni lub pośredni słownik adnotacji osiągnięty przez wpis Page /Annots musi zawierać wymagane wpisy /Subtype i /Rect
Walidacja /OCProperties katalogu wymaga tablicy /OCGs, słownika /D, prawidłowych domyślnych wartości /BaseState /ON i /Intent /View gdy są obecne oraz wpisów o wartościach tablicowych /Configs, /ON, /OFF, /AS i /Order
Zapisy plików używają pliku tymczasowego w tym samym katalogu i zastępują miejsce docelowe dopiero po pomyślnym przetworzeniu końcowym

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 Funkcja