AddPageFooter
Paginabewerking, annotaties
Beschrijving
Stempelt een lopende voetregel op één of meer pagina's van het geselecteerde document. De tekst wordt in overlaymodus getekend met het momenteel geselecteerde lettertype, stempeltokens zoals <%PageNo%> worden vóór het meten van de regel uitgebreid tegen elke doelpagina, en de gestempelde regel wordt ingesloten in een Pagination-artefact met subtype Footer, zodat readers voor getagd PDF hem behandelen als paginameubilair in plaats van als herhalende content
Syntaxis
Delphi
Function TPDFlib.AddPageFooter(Const PageRange, Text: WideString;
Margin, Opacity: Double; Alignment: Integer): Integer;Parameters
| PageRange | Paginabereikexpressie, of een lege string voor elke pagina |
|---|---|
| Text | Voettekst; de tokens die ExpandStampTokens begrijpt, worden uitgebreid tegen elke doelpagina |
| Margin | Afstand van de onderrand van de pagina tot de voetregel, in PDF-punten |
| Opacity | Tekstopaciteit tussen 0 en 1, waarbij 1 volledig dekkend tekent |
| Alignment | 0 lijnt links uit op de marge, 1 centreert tussen de marges, 2 lijnt rechts uit en houdt de margeafstand tot de rechterrand aan |
Retourwaarden
Het aantal pagina's waarop de voettekst is gestempeld, of 0 wanneer geen document is geselecteerd, Text leeg is of geen pagina van het bereik kon worden geselecteerd
Opmerkingen
De regel wordt gemeten met het huidige lettertype en de huidige grootte, roep dus eerst SelectFont aan; content die al op de pagina staat, blijft onder de overlay zichtbaar. De geselecteerde pagina wordt hersteld wanneer de aanroep terugkeert
Voor voetrollen voor de eerste pagina, oneven pagina's en even pagina's met ondersteuning voor HTML-content, zie ApplyPageHeaderFooterSet
Voorbeeld
PDF.SelectFont(PDF.AddStandardFont(sfHelvetica));
PDF.AddPageFooter('', '<%ShortDate%> - <%PageNo%>/<%TotalPages%>', 24, 0.8, 2);