BeginPageUpdate

Sivun asettelu

Kuvaus

Aloittaa eräpiirtotransaktion parhaillaan valitulla sivulla. Myöhemmät piirtokutsut (teksti, polut, kuvat, merkinnät) puskuroituvat yhteen erään ja huuhtelevat sivun sisältövirtaan, kun vastaava EndPageUpdate-kutsu tehdään

Käytä tätä, kun monimutkainen sivu kootaan monista pienistä piirtoelementeistä, etenkin kun aiemmin tallennettu sivu avataan uudelleen muokattavaksi. Eräys välttää kutsukohtaisen sisältövirran sarjallistusylimäärän ja pitää syntyvän sivun sisältövirran tiiviinä ja muodoltaan kelvollisena

Syntaksi

Delphi

Function TPDFlib.BeginPageUpdate: Integer;

ActiveX

Function PDFlib::BeginPageUpdate() As Long

DLL

int DLBeginPageUpdate(int InstanceID);

Paluuarvot

0	Epäonnistui — mikään asiakirja ei ole avoinna tai mikään sivu ei ole parhaillaan valittuna
1	Eräpiirtotransaktio on aloitettu

Huomautukset

Jokainen BeginPageUpdate-kutsu on paritettava yhden EndPageUpdate-kutsun kanssa samalla sivulla. Paria ei nimenomaisesti vaadita, kun sisältöä lisätään tuoreelle NewPagein juuri luomalle sivulle; silloin sivu on jo "avoinna kirjoitusta varten"-tilassa. Pari vaaditaan, kun aiemmin suljettu sivu avataan uudelleen (fon EndPagein tai asiakirjan lataamisen jälkeen) ja sen sisältöä muokataan

Sisäkkäisiä kutsuja ei tueta — kutsu funktiota EndPageUpdate ennen toisen sivun avaamista muokattavaksi

Esimerkki

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

Katso myös

EndPageUpdate, SelectPage, NewPage, EndPage