THotPDF.BeginDoc Méthode

BeginDoc démarre un nouveau document PDF et crée la première page. En usage normal, appelez BeginDoc avec la valeur de paramètre par défaut, puis dessinez sur CurrentPage

Une instance de THotPDF peut écrire autant de documents qu'on veut, l'un après l'autre. EndDoc écrit le fichier puis abandonne tout ce qui y était enregistré : images, polices, champs de formulaire, outlines, JavaScript de document, destinations nommées, étiquettes de page, profils ICC, output intents et les autres ressources. Les pages et objets du document écrit restent en mémoire, si bien que des contrôles comme ValidatePDFUA2Structure fonctionnent encore après EndDoc, jusqu'à ce que le prochain BeginDoc les libère. Le document suivant démarre donc proprement, et aucun contenu du fichier précédent n'y parvient

Les propriétés telles que FileName, Version, Compression, PDFACompliance, Author et Title conservent leurs valeurs pour le document suivant, ainsi que les couches de page, les chaînes de secours de polices et les sélections d'axes de polices variables. Tout ce qui est enregistré après EndDoc et avant le prochain BeginDoc, par exemple un output intent ajouté avec AddPDFAOutputIntent ou un script ajouté via Names, appartient au document suivant. CurrentPageNumber, PagesCount et les diagnostics de mise en page du document écrit restent aussi lisibles jusqu'au prochain BeginDoc

EndDoc efface UserPassword et OwnerPassword. Lorsque ActivateProtection reste actif, redéfinissez les mots de passe avant le prochain BeginDoc ; sinon BeginDoc lève une exception au lieu d'écrire un document protégé par des mots de passe vides. Lorsqu'une fonctionnalité d'un document a augmenté automatiquement la version PDF (par exemple vers PDF 1.4 pour un output intent), EndDoc la ramène à la valeur de la propriété Version

Exemple de code


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;