BeginPageUpdate

Оформление на страница

Описание

Стартира транзакция за пакетно рисуване върху текущо избраната страница. Следващите извиквания за рисуване (текст, пътища, изображения, анотации) се буферират в един общ пакет и се записват в потока със съдържание на страницата, когато бъде направено съответното извикване на EndPageUpdate

Използвайте това, когато сглобявате сложна страница от много малки графични примитиви, особено при повторно отваряне на вече запазена страница за редактиране. Пакетирането избягва натоварването от сериализиране на потока със съдържание при всяко извикване и държи получения поток със съдържание на страницата компактен и добре оформен.

Синтаксис

Delphi

Function TPDFlib.BeginPageUpdate: Integer;

ActiveX

Function PDFlib::BeginPageUpdate() As Long

DLL

int DLBeginPageUpdate(int InstanceID);

Върнати стойности

0	Неуспешно - няма отворен документ или няма текущо избрана страница
1	Транзакцията за пакетно рисуване е стартирана

Бележки

Всяко извикване на BeginPageUpdate трябва да бъде сдвоено с едно извикване на EndPageUpdate на същата страница. Двойката не е строго необходима при добавяне на съдържание към чисто нова страница, която току-що е създадена с NewPage; в този случай страницата вече е в състояние "отворена за запис". Двойката е необходима при повторно отваряне на по-рано затворена страница (след EndPage или след зареждане на документа) и промяна на нейното съдържание

Вложени извиквания не се поддържат - извикайте EndPageUpdate, преди да отворите друга страница за редактиране

Пример

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

Вижте също

EndPageUpdate, SelectPage, NewPage, EndPage