BeginPageUpdate

Sidlayout

Beskrivning

Startar en batchad ritningstransaktion på den för tillfället valda sidan. Efterföljande ritningsanrop (text, pather, bilder, annoteringar) buffras i en enda batch och spolas ut till sidans innehållsström när ett matchande EndPageUpdate-anrop görs

Använd det här när du bygger en komplex sida av många små ritprimitiver, särskilt när du återöppnar en tidigare sparad sida för redigering. Batchning undviker overheaden för content stream-serialisering per anrop och håller den resulterande sidans innehållsström kompakt och välformad

Syntax

Delphi

Function TPDFlib.BeginPageUpdate: Integer;

ActiveX

Function PDFlib::BeginPageUpdate() As Long

DLL

int DLBeginPageUpdate(int InstanceID);

Returvärden

0	Misslyckades — inget dokument är öppet eller ingen sida är för tillfället vald
1	Den batchade ritningstransaktionen har startats

Anmärkningar

Varje BeginPageUpdate-anrop måste paras med ett EndPageUpdate-anrop på samma sida. Paret är inte strikt krävt när innehåll läggs till en helt ny sida som precis skapats av NewPage; i så fall är sidan redan i tillståndet "öppen för skrivning". Paret är krävt när en tidigare stängd sida återöppnas (efter EndPage eller efter att dokumentet lästs in) och dess innehåll ändras

Nästlade anrop stöds inte — anropa EndPageUpdate innan du öppnar en annan sida för redigering

Exempel

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

Se även

EndPageUpdate, SelectPage, NewPage, EndPage