EndPageUpdate

Макет страницы

Описание

Закрывает транзакцию пакетного рисования, открытую последним вызовом BeginPageUpdate, и выгружает буферизованные операторы рисования в поток содержимого текущей страницы. Каждый вызов BeginPageUpdate должен быть спарен ровно с одним вызовом EndPageUpdate

Синтаксис

Delphi

Function TPDFlib.EndPageUpdate: Integer;

ActiveX

Function PDFlib::EndPageUpdate() As Long

DLL

int DLEndPageUpdate(int InstanceID);

Возвращаемые значения

0	Сбой — не открыт ни один документ, либо на выбранной странице сейчас нет активной транзакции BeginPageUpdate.
1	Транзакция закрыта, буферизованное содержимое зафиксировано на странице

Примечания

Вызов EndPageUpdate без парной BeginPageUpdate не дает эффекта и возвращает 0. Забытый EndPageUpdate после открытой транзакции оставляет буферизованные операторы рисования незакрепленными; при сохранении документа они будут потеряны

Пример

// Add a watermark on every page of an existing document
PDF.LoadFromFile('contract.pdf', '');
for I := 1 to PDF.GetPageCount do
begin
  PDF.SelectPage(I);
  PDF.BeginPageUpdate;
    PDF.SetTextColor(0.85, 0.85, 0.85);
    PDF.SetFontSize(72);
    PDF.PrintText(100, 400, 'CONFIDENTIAL');
  PDF.EndPageUpdate;
end;
PDF.SaveToFile('contract-confidential.pdf');

См. также

BeginPageUpdate, SelectPage, PageCount, EndPage