BeginPageUpdate

Page layout

Popis

Zahájí transakci dávkového kreslení na aktuálně vybrané stránce. Následující kreslicí volání (text, cesty, obrázky, anotace) se ukládají do jedné dávky a flushnou se do obsahového proudu stránky při párovém volání EndPageUpdate

Toto použijte při skládání složité stránky z mnoha malých kreslicích primitiv, obzvlášť při opětovném otevření dříve uložené stránky k editaci. Dávkování vyhne režii serializace obsahového proudu na volání a udrží výsledný obsahový proud stránky kompaktní a dobře formovaný

Syntaxe

Delphi

Function TPDFlib.BeginPageUpdate: Integer;

ActiveX

Function PDFlib::BeginPageUpdate() As Long

DLL

int DLBeginPageUpdate(int InstanceID);

Return values

0	Failed — no document is open or no page is currently selected.
1	Transakce dávkového kreslení byla zahájena

Poznámky

Každé volání BeginPageUpdate musí být na stejné stránce spárováno s jedním voláním EndPageUpdate Dvojice není bezpodmínečně nutná při přidávání obsahu na zcela novou stránku právě vytvořenou voláním NewPage; v tom případě je stránka již ve stavu "otevřena pro zápis" Dvojice je nutná při opětovném otevření dříve uzavřené stránky (po EndPage nebo po načtení dokumentu) a úpravě jejího obsahu

Nested calls are not supported — call EndPageUpdate before opening a different page for editing.

Příklad

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

Viz také

EndPageUpdate, SelectPage, NewPage, EndPage