AddPageFooter
Manipolazione delle pagine, annotazioni
Descrizione
Timbra una riga di piè di pagina ricorrente su una o più pagine del documento selezionato. Il testo viene disegnato in modalità overlay con il font attualmente selezionato, i token di timbratura come <%PageNo%> vengono espansi rispetto a ciascuna pagina di destinazione prima che la riga sia misurata, e la riga timbrata è racchiusa in un artifact Pagination con sottotipo Footer, così che i lettori di tagged PDF la trattino come elemento di pagina e non come contenuto ripetuto
Sintassi
Delphi
Function TPDFlib.AddPageFooter(Const PageRange, Text: WideString;
Margin, Opacity: Double; Alignment: Integer): Integer;Parametri
| PageRange | Espressione di intervallo di pagine, oppure stringa vuota per tutte le pagine |
|---|---|
| Text | Testo del piè di pagina; i token riconosciuti da ExpandStampTokens si espandono rispetto a ciascuna pagina di destinazione |
| Margin | Distanza dal bordo inferiore della pagina alla riga del piè di pagina, in punti PDF |
| Opacity | Opacità del testo tra 0 e 1, dove 1 disegna completamente opaco |
| Alignment | 0 allinea a sinistra al margine, 1 centra tra i margini, 2 allinea a destra mantenendo la distanza di margine dal bordo destro |
Valori restituiti
Il numero di pagine su cui è stato timbrato il piè di pagina, oppure 0 quando nessun documento è selezionato, Text è vuota o nessuna pagina dell'intervallo può essere selezionata
Osservazioni
La riga viene misurata con il font e la dimensione correnti, quindi chiamare prima SelectFont; il contenuto già presente sulla pagina resta visibile sotto l'overlay. La pagina selezionata viene ripristinata al ritorno della chiamata
Per i ruoli di piè di pagina prima pagina, dispari e pari con supporto di contenuto HTML vedere ApplyPageHeaderFooterSet
Esempio
PDF.SelectFont(PDF.AddStandardFont(sfHelvetica));
PDF.AddPageFooter('', '<%ShortDate%> - <%PageNo%>/<%TotalPages%>', 24, 0.8, 2);