THotPDF.BeginDoc

THotPDF

Creates new document

Delphi syntax:

procedure BeginDoc ( Initial: boolean = false );

C++ syntax:

void __fastcall BeginDoc ( bool Initial = false );

Description

BeginDoc starts a new PDF document and creates the first page. In normal usage, call BeginDoc with the default parameter value and then draw on CurrentPage

THotPDF 인스턴스 하나는 문서를 여러 개든 차례로 쓸 수 있습니다. EndDoc은 파일을 쓴 뒤 그 문서에 등록된 것 전부, 즉 이미지, 폰트, 폼 필드, 아웃라인, 문서 JavaScript, named destination, 페이지 레이블, ICC 프로필, output intent와 나머지 리소스를 버립니다. 쓰인 문서의 페이지와 객체는 메모리에 남아 있으므로 ValidatePDFUA2Structure 같은 검사는 EndDoc 뒤에도 다음 BeginDoc이 해제할 때까지 계속 동작합니다. 따라서 다음 문서는 깨끗한 상태로 시작하고, 이전 파일의 내용은 어느 것도 넘어가지 않습니다

FileName, Version, Compression, PDFACompliance, Author, Title 같은 property는 페이지 layer, 폰트 fallback 체인, variable-font 축 선택과 함께 다음 문서용으로 값을 유지합니다. EndDoc 뒤, 다음 BeginDoc 전에 등록한 것, 예컨대 AddPDFAOutputIntent로 추가한 output intent나 Names로 추가한 스크립트는 다음 문서에 속합니다. 쓰인 문서의 CurrentPageNumber, PagesCount와 layout 진단도 다음 BeginDoc까지 읽을 수 있습니다

EndDoc은 UserPassword와 OwnerPassword를 지웁니다. ActivateProtection이 여전히 켜져 있으면 다음 BeginDoc 전에 암호를 다시 설정하십시오. 그렇지 않으면 BeginDoc은 빈 암호로 보호되는 문서를 쓰는 대신 예외를 일으킵니다. 한 문서의 feature가 PDF 버전을 자동으로 올렸다면(예컨대 output intent 때문에 PDF 1.4로), EndDoc은 Version property 값으로 되돌립니다

HPDF := THotPDF.Create( nil );
try
  HPDF.FileName := '.\Output.pdf';
  HPDF.BeginDoc;   // Start PDF document creation
  HPDF.CurrentPage.TextOut( 100, 100, 0, 'Hello World!' );
  HPDF.EndDoc;     // Finish and save PDF document

  HPDF.FileName := '.\Second.pdf';
  HPDF.BeginDoc;   // Same instance, new independent document
  HPDF.CurrentPage.TextOut( 100, 100, 0, 'Second document' );
  HPDF.EndDoc;
finally
  HPDF.Free;
end;

See also: EndDoc