THotPDF.BeginDoc Methode

BeginDoc start een nieuw PDF-document en maakt de eerste pagina aan. Roep BeginDoc normaal gesproken aan met de standaardparameterwaarde en teken daarna op CurrentPage

Eén THotPDF-instantie kan een willekeurig aantal documenten na elkaar schrijven. EndDoc schrijft het bestand en verwijdert vervolgens alles wat ervoor is geregistreerd: afbeeldingen, fonts, formuliervelden, outlines, document-JavaScript, named destinations, page labels, ICC-profielen, output intents en de overige resources. De pagina's en objecten van het geschreven document blijven in het geheugen, zodat controles zoals ValidatePDFUA2Structure na EndDoc blijven werken, tot de volgende BeginDoc ze vrijgeeft. Het volgende document begint daardoor schoon, en geen enkele inhoud van het vorige bestand komt erin terecht

Properties zoals FileName, Version, Compression, PDFACompliance, Author en Title behouden hun waarde voor het volgende document, samen met paginalagen, font-fallback-ketens en selecties van variabele-font-assen. Alles wat na EndDoc en vóór de volgende BeginDoc wordt geregistreerd, bijvoorbeeld een output intent die met AddPDFAOutputIntent is toegevoegd of een script die via Names is toegevoegd, hoort bij het volgende document. CurrentPageNumber, PagesCount en de lay-outdiagnostiek van het geschreven document blijven ook leesbaar tot de volgende BeginDoc

EndDoc wist UserPassword en OwnerPassword. Wanneer ActivateProtection nog aanstaat, stel de wachtwoorden dan opnieuw in vóór de volgende BeginDoc; anders genereert BeginDoc een exception in plaats van een document met lege wachtwoorden te beschermen. Wanneer een functie van één document de PDF-versie automatisch heeft verhoogd (bijvoorbeeld naar PDF 1.4 voor een output intent), zet EndDoc deze terug op de waarde van de property Version

Codevoorbeeld


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;