BeginPageUpdate

Diseño de página

Descripción

Inicia una transacción de dibujo por lotes en la página seleccionada actualmente Las llamadas de dibujo posteriores (texto, trazados, imágenes y anotaciones) se almacenan en un único lote y se vacían en el flujo de contenido de la página al realizar una llamada correspondiente a EndPageUpdate

Use esto al armar una página compleja con muchas primitivas pequeñas de dibujo, especialmente al volver a abrir para editar una página guardada anteriormente El procesamiento por lotes evita la sobrecarga de serialización del flujo de contenido por llamada y mantiene el flujo de contenido de la página resultante compacto y bien formado

Sintaxis

Delphi

Function TPDFlib.BeginPageUpdate: Integer;

ActiveX

Function PDFlib::BeginPageUpdate() As Long

DLL

int DLBeginPageUpdate(int InstanceID);

Valores devueltos

Observaciones

Cada llamada a BeginPageUpdate debe emparejarse con una llamada a EndPageUpdate en la misma página El par no es estrictamente necesario al agregar contenido a una página nueva creada mediante NewPage; en ese caso la página ya está en estado "abierta para escritura" El par sí es necesario al volver a abrir una página cerrada anteriormente (después de EndPage o después de cargar el documento) y modificar su contenido

No se admiten llamadas anidadas — llame a EndPageUpdate antes de abrir una página diferente para editar

Ejemplo

// Add a stamp on an existing page of a loaded document
PDF.LoadFromFile('contract.pdf', '');
PDF.SelectPage(1);
PDF.BeginPageUpdate;
  PDF.SetTextColor(0.8, 0, 0);
  PDF.SetFontSize(48);
  PDF.PrintText(150, 400, 'DRAFT');
PDF.EndPageUpdate;
PDF.SaveToFile('contract-stamped.pdf');

Véase también

EndPageUpdate, SelectPage, NewPage, EndPage