BeginPageUpdate

Disposition des pages

Description

Démarre une transaction de tracé par lots sur la page sélectionnée. Les appels suivants (texte, chemins, images, annotations) sont mis en tampon dans un seul lot et vidés vers le flux de contenu de la page lors de l’appel correspondant à EndPageUpdate

Utilisez cette fonction pour assembler une page complexe à partir de nombreuses petites primitives, en particulier lors de la réouverture d’une page enregistrée pour modification. Le traitement par lots évite le coût de sérialisation du flux à chaque appel et maintient le flux obtenu compact et bien formé

Syntaxe

Delphi

Function TPDFlib.BeginPageUpdate: Integer;

ActiveX

Function PDFlib::BeginPageUpdate() As Long

DLL

int DLBeginPageUpdate(int InstanceID);

Valeurs de retour

Remarques

Chaque appel à BeginPageUpdate doit être associé à un appel à EndPageUpdate sur la même page. Cette paire n’est pas strictement nécessaire lors de l’ajout de contenu à une page entièrement nouvelle créée par NewPage, car elle est déjà dans l’état "ouvert pour écriture". Elle est nécessaire lorsqu’une page précédemment fermée est rouverte (après EndPage ou le chargement du document) afin d’en modifier le contenu

Les appels imbriqués ne sont pas pris en charge — appelez EndPageUpdate avant d'ouvrir une autre page pour modification

Exemple

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

Voir aussi

EndPageUpdate, SelectPage, NewPage, EndPage