BeginPageUpdate

Layout di pagina

Descrizione

Avvia una transazione di disegno batch sulla pagina attualmente selezionata. Le chiamate di disegno successive, per testo, tracciati, immagini e annotazioni, vengono memorizzate nel buffer in un unico batch e scaricate nel flusso di contenuto della pagina quando viene effettuata una chiamata corrispondente a EndPageUpdate

Usare per pagine complesse con molte primitive, soprattutto riaprendo una pagina salvata. Il batch evita serializzazione per chiamata e mantiene compatto e valido il flusso

Sintassi

Delphi

Function TPDFlib.BeginPageUpdate: Integer;

ActiveX

Function PDFlib::BeginPageUpdate() As Long

DLL

int DLBeginPageUpdate(int InstanceID);

Valori restituiti

0	Operazione non riuscita — nessun documento aperto o nessuna pagina attualmente selezionata
1	La transazione di disegno in batch è stata avviata

Note

Ogni chiamata BeginPageUpdate deve essere abbinata a una chiamata EndPageUpdate sulla stessa pagina. La coppia non è strettamente necessaria quando si aggiunge contenuto a una pagina nuova appena creata da NewPage; in tal caso, la pagina è già nello stato "open for writing". La coppia is necessaria quando si riapre una pagina chiusa in precedenza, dopo EndPage o dopo il caricamento del documento, e se ne modifica il contenuto

Le chiamate annidate non sono supportate — chiamare EndPageUpdate prima di aprire una pagina diversa per la modifica.

Esempio

// 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');

Vedere anche

EndPageUpdate, SelectPage, NewPage, EndPage