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 vuelcan en el flujo de contenido de la página cuando se realiza una llamada coincidente a EndPageUpdate

Utilice esta opción al componer una página compleja a partir de muchas primitivas de dibujo pequeñas, 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 en cada llamada y mantiene el flujo de contenido de 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

0	Error — no hay ningún documento abierto o no hay ninguna página seleccionada actualmente
1	Se ha iniciado la transacción de dibujo por lotes

Observaciones

Cada BeginPageUpdate requiere un EndPageUpdate en la misma página. No es imprescindible en una nueva de NewPage, ya "abierta para escritura", pero sí al reabrir una cerrada tras EndPage o cargar

No se admiten llamadas anidadas — llame a EndPageUpdate antes de abrir otra página para editarla

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