AddPageFooter
Manipulação de página, Anotações
Descrição
Estampa uma linha de rodapé contínuo em uma ou mais páginas do documento selecionado. O texto é desenhado em modo de sobreposição com a fonte atualmente selecionada, tokens de carimbo como <%PageNo%> são expandidos em relação a cada página de destino antes que a linha seja medida, e a linha estampada é envolvida em um artefato de Paginação com subtipo Footer, de modo que leitores de PDF com tags a tratem como elemento fixo da página, e não como conteúdo repetido
Sintaxe
Delphi
Function TPDFlib.AddPageFooter(Const PageRange, Text: WideString;
Margin, Opacity: Double; Alignment: Integer): Integer;Parâmetros
| PageRange | Expressão de intervalo de páginas, ou uma string vazia para todas as páginas |
|---|---|
| Text | Texto do rodapé; os tokens compreendidos por ExpandStampTokens expandem em relação a cada página de destino |
| Margin | Distância da borda inferior da página até a linha do rodapé, em pontos PDF |
| Opacity | Opacidade do texto entre 0 e 1, em que 1 desenha totalmente opaco |
| Alignment | 0 alinha à esquerda na margem, 1 centraliza entre as margens, 2 alinha à direita mantendo a distância da margem até a borda direita |
Valores de retorno
O número de páginas em que o rodapé foi estampado, ou 0 quando nenhum documento está selecionado, Text está vazio ou nenhuma página do intervalo pôde ser selecionada
Observações
A linha é medida com a fonte e o tamanho atuais, portanto chame SelectFont primeiro; o conteúdo já presente na página permanece visível sob a sobreposição. A página selecionada é restaurada quando a chamada retorna
Para papéis de rodapé de primeira página, página ímpar e página par, com suporte a conteúdo HTML, consulte ApplyPageHeaderFooterSet
Exemplo
PDF.SelectFont(PDF.AddStandardFont(sfHelvetica));
PDF.AddPageFooter('', '<%ShortDate%> - <%PageNo%>/<%TotalPages%>', 24, 0.8, 2);