ApplyPageHeaderFooterSet

Layout di pagina, impaginazione, testo HTML

Descrizione

Applica intestazioni e piè di pagina denominati a un intervallo con selezione prima pagina e parità fisica

Sintassi

Delphi

Function TPDFlib.ApplyPageHeaderFooterSet(Const SetName,
  PageRange: WideString): Integer;

ActiveX

Function PDFlib::ApplyPageHeaderFooterSet(SetName As String,
  PageRange As String) As Long

DLL

int DLApplyPageHeaderFooterSet(int InstanceID, const wchar_t* SetName,
  const wchar_t* PageRange);
int DLApplyPageHeaderFooterSetA(int InstanceID, const char* SetName,
  const char* PageRange);

Parametri

SetName	Nome senza distinzione tra maiuscole e minuscole registrato in precedenza con SetPageHeaderFooterVariant
PageRange	Espressione di intervallo di pagine, oppure stringa vuota per tutte le pagine

Valori restituiti

Restituisce il numero di intestazioni e piè di pagina non vuoti disegnati, oppure 0 se insieme o intervallo non hanno contenuto applicabile o l'ambito API non può cambiare pagina

Note

Per ogni ruolo di intestazione e piè di pagina, la prima pagina restituita dall'intervallo usa first quando definito; le pagine successive usano odd o even in base al rispettivo numero fisico e le varianti specifiche mancanti ricorrono a default

Una variante vuota esplicita non disegna nulla e impedisce il fallback, supportando prime pagine vuote

Ogni modello viene espanso rispetto alla pagina prima della misurazione e le varianti HTML usano il markup espanso per calcolare automaticamente l'altezza

Il contenuto generato viene contrassegnato come artefatto di impaginazione e vengono ripristinati pagina selezionata, font, stato del painter e impostazione della crenatura del chiamante

Esempio

PDF.SetPageHeaderFooterVariant('manual', 'default',
  '<b>Manual</b> — <%PageNo%>/<%TotalPages%>', 36, 0, 0.8, 2, 0, 1);
if PDF.ApplyPageHeaderFooterSet('manual', '3-20')= 0 then
  HandleLayoutError;