BeginPageUpdate

Pagina-indeling

Beschrijving

Start een batchteken-transactie op de momenteel geselecteerde pagina. daaropvolgende tekenaanroepen (tekst, paden, afbeeldingen, annotaties) worden in één batch gebufferd en naar de contentstream van de pagina gespoeld zodra een bijbehorende aanroep van EndPageUpdate plaatsvindt

Gebruik dit bij het samenstellen van een complexe pagina uit veel kleine tekenprimitieven, vooral wanneer een eerder opgeslagen pagina opnieuw voor bewerking wordt geopend. Batchen voorkomt de serialisatieoverhead per aanroep en houdt de resulterende pagina-contentstream compact en goed gevormd

Syntaxis

Delphi

Function TPDFlib.BeginPageUpdate: Integer;

ActiveX

Function PDFlib::BeginPageUpdate() As Long

DLL

int DLBeginPageUpdate(int InstanceID);

Retourwaarden

0	Failed — no document is open or no page is currently selected.
1	De transactie voor batchgewijs tekenen is gestart

Opmerkingen

Elke aanroep van BeginPageUpdate moet op dezelfde pagina worden gepaard met één aanroep van EndPageUpdate. Het paar is niet strikt vereist wanneer je inhoud toevoegt aan een gloednieuwe pagina die zojuist door NewPage is aangemaakt; in dat geval bevindt de pagina zich al in de status "open for writing". Het paar is wel vereist wanneer je een eerder gesloten pagina opnieuw opent (na EndPage of na het laden van het document) en de inhoud ervan wijzigt

Geneste aanroepen worden niet ondersteund — roep EndPageUpdate aan voordat je een andere pagina voor bewerking opent

Voorbeeld

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

Zie ook

EndPageUpdate, SelectPage, NewPage, EndPage