BeginPageUpdate

Sidelayout

Beskrivelse

Starter en batchtegningstransaktion på den aktuelt valgte side. Efterfølgende tegnekald (tekst, stier, billeder, annoteringer) bufferlagres i en enkelt batch og skrives til sidens indholdsstrøm, når der foretages et tilsvarende kald til EndPageUpdate.

Brug dette, når en kompleks side sammensættes af mange små tegneprimitiver, især når en tidligere gemt side åbnes igen til redigering. Batchbehandling undgår overhead ved serialisering af indholdsstrømmen for hvert kald og holder den resulterende sideindholdsstrøm kompakt og velformet.

Syntaks

Delphi

Function TPDFlib.BeginPageUpdate: Integer;

ActiveX

Function PDFlib::BeginPageUpdate() As Long

DLL

int DLBeginPageUpdate(int InstanceID);

Returværdier

0	Mislykkedes — intet dokument er åbent, eller ingen side er valgt i øjeblikket.
1	Transaktionen til batchtegning er startet

Bemærkninger

Hvert kald til BeginPageUpdate skal parres med ét kald til EndPageUpdate på samme side. Parret er ikke strengt nødvendigt, når indhold føjes til en helt ny side, der netop er oprettet med NewPage; i så fald er siden allerede i tilstanden "åben til skrivning". Parret er nødvendigt, når en tidligere lukket side åbnes igen (efter EndPage eller efter indlæsning af dokumentet), og dens indhold ændres

Indlejrede kald understøttes ikke — kald EndPageUpdate, før du åbner en anden side til redigering.

Eksempel

// 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 også

EndPageUpdate, SelectPage, NewPage, EndPage