BeginPageUpdate

Disposição da página

Descrição

Inicia uma transação de desenho em lote na página atualmente selecionada. As chamadas de desenho seguintes (texto, caminhos, imagens, anotações) são colocadas num único lote em memória intermédia e descarregadas no fluxo de conteúdo da página quando é efetuada uma chamada EndPageUpdate correspondente

Utilize esta opção ao montar uma página complexa a partir de muitos elementos primitivos de desenho pequenos, sobretudo quando reabrir uma página anteriormente guardada para edição. O processamento em lote evita a sobrecarga de serialização do fluxo de conteúdo em cada chamada e mantém o fluxo de conteúdo da página resultante compacto e bem formado

Sintaxe

Delphi

Function TPDFlib.BeginPageUpdate: Integer;

ActiveX

Function PDFlib::BeginPageUpdate() As Long

DLL

int DLBeginPageUpdate(int InstanceID);

Valores devolvidos

Observações

Cada chamada BeginPageUpdate tem de ser emparelhada com uma chamada EndPageUpdate na mesma página. O par não é estritamente necessário ao adicionar conteúdo a uma página totalmente nova que acabou de ser criada por NewPage; nesse caso, a página já está no estado "aberta para escrita". O par é necessário ao reabrir uma página anteriormente fechada (após EndPage ou o carregamento do documento) e modificar o respetivo conteúdo

Não são suportadas chamadas aninhadas — chame EndPageUpdate antes de abrir outra página para edição

Exemplo

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

Consulte também

EndPageUpdate, SelectPage, NewPage, EndPage