BeginPageUpdate

Oldalelrendezés

Leírás

Kötegelt rajzolási tranzakciót indít az aktuálisan kijelölt oldalon. A későbbi rajzolási hívások (szöveg, útvonalak, képek, jegyzetek) egyetlen kötegbe pufferelődnek, és a hozzá tartozó EndPageUpdate híváskor kiürülnek az oldal tartalomadatfolyamába

Használja ezt összetett, sok kis rajzolási primitívből álló oldal összeállításakor, különösen korábban mentett oldal újbóli megnyitásakor szerkesztéshez. A kötegelt feldolgozás elkerüli a hívásonkénti tartalmi adatfolyam-szerializálási többletet, és a kapott oldal tartalmi adatfolyamát tömören és helyesen formázva tartja

Szintaxis

Delphi

Function TPDFlib.BeginPageUpdate: Integer;

ActiveX

Function PDFlib::BeginPageUpdate() As Long

DLL

int DLBeginPageUpdate(int InstanceID);

Visszatérési értékek

0	Sikertelen – nincs nyitott dokumentum, vagy nincs jelenleg kijelölt oldal
1	A kötegelt rajzolási tranzakció elindult

Megjegyzések

Minden BeginPageUpdate hívást ugyanazon az oldalon egy EndPageUpdate hívásnak kell követnie. A pár nem feltétlenül szükséges, ha éppen a NewPage által létrehozott új oldalhoz ad hozzá tartalmat, mert az oldal ekkor már "írásra megnyitott" állapotban van. A pár szükséges egy korábban lezárt oldal újbóli megnyitásakor (a EndPage után vagy a dokumentum betöltése után), illetve a tartalmának módosításakor

A beágyazott hívások nem támogatottak — szerkesztésre szolgáló másik oldal megnyitása előtt hívja meg a(z) EndPageUpdate függvényt

Példa

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

Lásd még

EndPageUpdate, SelectPage, NewPage, EndPage