BeginPageUpdate

Układ strony

Opis

Rozpoczyna transakcję rysowania wsadowego na aktualnie wybranej stronie. Kolejne wywołania rysujące (tekst, ścieżki, obrazy, adnotacje) są buforowane w jednej partii i zapisywane do strumienia zawartości strony po wykonaniu odpowiadającego wywołania EndPageUpdate.

Użyj tej funkcji podczas składania złożonej strony z wielu małych elementów rysunkowych, zwłaszcza po ponownym otwarciu wcześniej zapisanej strony do edycji. Przetwarzanie wsadowe eliminuje narzut serializacji strumienia zawartości przy każdym wywołaniu i pozwala zachować zwarty, poprawnie sformułowany strumień zawartości strony.

Składnia

Delphi

Function TPDFlib.BeginPageUpdate: Integer;

ActiveX

Function PDFlib::BeginPageUpdate() As Long

DLL

int DLBeginPageUpdate(int InstanceID);

Wartości zwracane

0	Niepowodzenie — brak otwartego dokumentu albo nie wybrano aktualnie strony.
1	Transakcja rysowania wsadowego została rozpoczęta.

Uwagi

Każde wywołanie BeginPageUpdate musi być sparowane z jednym wywołaniem EndPageUpdate na tej samej stronie. Para nie jest bezwzględnie wymagana podczas dodawania zawartości do nowej strony utworzonej właśnie przez NewPage; taka strona jest już w stanie "otwarta do zapisu". Para jest wymagana po ponownym otwarciu wcześniej zamkniętej strony (po EndPage lub po wczytaniu dokumentu) i modyfikowaniu jej zawartości.

Wywołania zagnieżdżone nie są obsługiwane — przed otwarciem innej strony do edycji wywołaj EndPageUpdate.

Przykład

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

Zobacz również

EndPageUpdate, SelectPage, NewPage, EndPage