EndPageUpdate

Layout da página

Descrição

Fecha a transação de desenho em lote aberta pela chamada mais recente de BeginPageUpdate e descarrega os operators de desenho em buffer no content stream da página atual. Toda chamada a BeginPageUpdate deve ser emparelhada com exatamente uma chamada a EndPageUpdate.

Sintaxe

Delphi

Function TPDFlib.EndPageUpdate: Integer;

ActiveX

Function PDFlib::EndPageUpdate() As Long

DLL

int DLEndPageUpdate(int InstanceID);

Valores retornados

0	Falhou — não há documento aberto ou nenhuma transação BeginPageUpdate está ativa na página selecionada.
1	A transação foi fechada e o conteúdo em buffer foi confirmado na página.

Observações

Chamar EndPageUpdate sem uma chamada correspondente de BeginPageUpdate não tem efeito algum e retorna 0. Esquecer de chamar EndPageUpdate depois de abrir uma transação deixa os operators de desenho em buffer sem commit; eles serão perdidos quando o documento for salvo.

Exemplo

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

Veja também

BeginPageUpdate, SelectPage, PageCount, EndPage