THotPDF.BeginDoc Método

BeginDoc inicia un documento PDF nuevo y crea la primera página. En uso normal, llame a BeginDoc con el valor de parámetro predeterminado y luego dibuje en CurrentPage

Una instancia de THotPDF puede escribir cualquier cantidad de documentos, uno tras otro. EndDoc escribe el archivo y luego suelta todo lo registrado para él: imágenes, fuentes, campos de formulario, outlines, JavaScript del documento, named destinations, page labels, perfiles ICC, output intents y los demás recursos. Las páginas y los objetos del documento escrito permanecen en memoria, así que verificaciones como ValidatePDFUA2Structure siguen funcionando después de EndDoc, hasta que el siguiente BeginDoc los libera. El siguiente documento por lo tanto empieza limpio, y ningún contenido del archivo anterior llega a él

Propiedades como FileName, Version, Compression, PDFACompliance, Author y Title conservan sus valores para el siguiente documento, junto con las capas de página, las cadenas de fallback de fuentes y las selecciones de ejes de fuentes variables. Todo lo registrado después de EndDoc y antes del siguiente BeginDoc, por ejemplo un output intent agregado con AddPDFAOutputIntent o un script agregado por medio de Names, pertenece al siguiente documento. CurrentPageNumber, PagesCount y los diagnósticos de layout del documento escrito también siguen siendo legibles hasta el siguiente BeginDoc

EndDoc limpia UserPassword y OwnerPassword. Cuando ActivateProtection sigue activada, vuelva a establecer las contraseñas antes del siguiente BeginDoc; de lo contrario BeginDoc lanza una excepción en lugar de escribir un documento protegido con contraseñas vacías. Cuando una feature de un documento elevó la versión de PDF automáticamente (por ejemplo a PDF 1.4 para un output intent), EndDoc la devuelve al valor de la propiedad Version

Ejemplo de código


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;