PDFium Delphi Component Docs

SaveAs 메서드

컴포넌트: TPdf  ·  유닛: PDFium
지정한 스트림이나 파일에 PDF 문서 사본을 저장하며, 명시적인 PDF 1.3부터 PDF 1.7까지 정규화와 conformance 검사를 수행합니다

Syntax

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

StreamPDF 데이터를 받을 TStream 값
OptionTSaveOption. 저장 옵션: 일반 저장은 saNone, 증분 업데이트는 saIncremental, 전체 재작성 강제는 saNoIncremental, 저장하며 보안 제거는 saRemoveSecurity
PdfVersionTPdfVersion 대상. 현재 버전을 유지하려면 pvUnknown 사용

 

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

FileNamestring. 출력 파일 경로입니다. 같은 디렉터리의 임시 파일을 먼저 완성한 뒤 대상을 원자적으로 교체합니다
OptionTSaveOption. 저장 옵션: saNone, saIncremental, saNoIncremental, saRemoveSecurity
PdfVersionTPdfVersion 대상. 현재 버전을 유지하려면 pvUnknown 사용

Return Value

문서가 성공적으로 저장되었으면 True, 실패하면 False를 반환합니다

Description

현재 문서를 파일 경로나 TStream에 저장합니다

PdfVersion 파라미터는 출력 PDF 버전을 지정하며, 문서의 기존 버전을 유지하려면 pvUnknown을 넘기세요

스트림 압축은 Compressed 프로퍼티가 제어합니다. 고전 xref 재작성으로 완전한 교차 참조 의미를 유지할 수 없는 입력이라도 하이브리드 참조, xref 스트림, 오브젝트 스트림 입력은 보존됩니다

모든 전체(비증분) 저장은 배열 범위 항목이 문자 매핑과 모순되는 subset 폰트 ToUnicode CMap을 복구하므로, 다시 연 문서에서 U+00A0와 U+00AD 대신 원래의 공백과 하이픈이 추출됩니다. 증분 리비전, sparse 업데이트, 교차 참조 스트림 문서는 그대로 통과합니다

명시적 PDF 버전 검사는 활성 교차 참조 리비전 체인과 활성 오브젝트 스트림 멤버를 따르므로, 낡았거나 참조되지 않는 오브젝트 본문은 요청한 버전 게이트에 영향을 주지 않습니다

파일 오버로드는 압축, 후처리, 버전 검증이 실패하면 기존 대상 파일을 그대로 둡니다

v3.125.2 Windows V8 업데이트는 테스트된 packet 배열과 지원되는 single-stream XDP 하위 집합에서 필드 값의 정확한 지속성을 수선했습니다. 오래된 런타임은 single-stream 편집을 버리거나 불필요한 개행을 추가할 수 있습니다

XFA 출력은 받아들이기 전에 다시 열어 필요한 필드 값을 정확히 비교하세요. 공백을 잘라내어 지속성 차이를 감추면 안 됩니다

Conformance behavior

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;

See Also

LoadDocument, Compressed, CreateDocument