THotPDF.BeginDoc

THotPDF

Creates new document.

Delphi syntax:

procedure BeginDoc ( Initial: boolean = false );

C++ syntax:

void __fastcall BeginDoc ( bool Initial = false );

Opis

BeginDoc rozpoczyna nowy dokument PDF i tworzy pierwszą stronę. W typowym użyciu wywołaj BeginDoc z domyślną wartością parametru, a następnie rysuj na CurrentPage

Jedna instancja THotPDF może zapisywać dowolną liczbę dokumentów, jeden po drugim. EndDoc zapisuje plik, a potem porzuca wszystko zarejestrowane dla niego: obrazy, fonty, pola formularzy, konspekty, JavaScript dokumentu, destynacje nazwane, etykiety stron, profile ICC, output intents i pozostałe zasoby. Strony i obiekty zapisanego dokumentu zostają w pamięci, więc testy takie jak ValidatePDFUA2Structure działają dalej po EndDoc, aż do następnego BeginDoc, które je zwalnia. Następny dokument startuje więc na czysto i żadna zawartość poprzedniego pliku nie trafia do niego

Właściwości takie jak FileName, Version, Compression, PDFACompliance, Author i Title zachowują wartości dla kolejnego dokumentu, razem z warstwami stron, łańcuchami fallbacku fontów i wyborami osi fontów zmiennych. Cokolwiek zarejestrowanego po EndDoc a przed następnym BeginDoc, na przykład output intent dodany przez AddPDFAOutputIntent albo skrypt dodany przez Names, należy do następnego dokumentu. CurrentPageNumber, PagesCount i diagnostyka układu zapisanego dokumentu pozostają też czytelne do następnego BeginDoc

EndDoc czyści UserPassword i OwnerPassword. Gdy ActivateProtection jest nadal włączone, ustaw hasła ponownie przed następnym BeginDoc; w przeciwnym razie BeginDoc zgłasza wyjątek zamiast zapisać dokument chroniony pustymi hasłami. Gdy funkcja jednego dokumentu podniosła wersję PDF automatycznie (na przykład do PDF 1.4 dla output intentu), EndDoc przywraca ją do wartości właściwości Version

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;

Zobacz też: EndDoc