THotPDF.BeginDoc Método

 

THotPDF.BeginDoc

THotPDF

 

Arriba  Anterior  Siguiente

Crea un documento nuevo

 

Sintaxis Delphi:

procedure BeginDoc ( Initial: boolean = false );

 

Sintaxis C++:

void __fastcall BeginDoc ( bool Initial = false );

 

Descripción

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

Una instancia de THotPDF puede escribir cualquier número de documentos, uno tras otro. EndDoc escribe el archivo y después suelta todo lo registrado para él: imágenes, fuentes, campos de formulario, outlines, JavaScript del documento, destinos con nombre, etiquetas de página, perfiles ICC, output intents y los demás recursos. Las páginas y los objetos del documento escrito permanecen en memoria, de modo que comprobaciones como ValidatePDFUA2Structure siguen funcionando después de EndDoc, hasta que el siguiente BeginDoc los libera. El documento siguiente 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 documento siguiente, junto con las capas de página, las cadenas de fallback de fuentes y las selecciones de ejes de fuentes variables. Todo lo que se registre después de EndDoc y antes del siguiente BeginDoc, por ejemplo un output intent añadido con AddPDFAOutputIntent o un script añadido a través de Names, pertenece al documento siguiente. 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 activado, 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 funcionalidad de un documento elevó automáticamente la versión PDF (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;

 

Véase también: EndDoc