BeginPageUpdate

Raspored stranice

Opis

Pokreće transakciju grupisanog crtanja na trenutno izabranoj stranici. Sledeći pozivi crtanja (tekst, putanje, slike, anotacije) baferisu se u jedan paket i isprazne u content stream stranice kad se pozove odgovarajući EndPageUpdate

Koristite ovu funkciju prilikom sklapanja složene stranice od mnogo malih grafičkih primitiva, posebno kad se ponovo otvara ranije sačuvana stranica radi izmene. Grupisanje izbegava trošak serijalizacije content stream-a po pozivu i čini rezultujući content stream stranice kompaktnim i dobro oblikovanim

Sintaksa

Delphi

Function TPDFlib.BeginPageUpdate: Integer;

ActiveX

Function PDFlib::BeginPageUpdate() As Long

DLL

int DLBeginPageUpdate(int InstanceID);

Povratne vrednosti

0	Failed — no document is open or no page is currently selected.
1	Transakcija grupisanog crtanja je pokrenuta

Napomene

Svakom pozivu BeginPageUpdate mora odgovarati jedan poziv EndPageUpdate nad istom stranicom. Par nije strogo obavezan kod dodavanja sadržaja na potpuno novu stranicu koju je upravo napravila NewPage; u tom slučaju stranica je već u stanju "otvoreno za pisanje". Par je obavezan kada se ponovo otvara ranije zatvorena stranica (nakon EndPage ili nakon učitavanja dokumenta) i menja njen sadržaj

Ugnježdeni pozivi nisu podržani — pozovite EndPageUpdate pre otvaranja druge stranice za uređivanje.

Primer

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

Vidi takođe

EndPageUpdate, SelectPage, NewPage, EndPage