SetPageHeaderFooterVariant

Layout di pagina, impaginazione, testo HTML

Descrizione

Crea o sostituisce una variante in un insieme denominato riutilizzabile di intestazioni e piè di pagina correnti

Sintassi

Delphi

Function TPDFlib.SetPageHeaderFooterVariant(Const SetName, VariantName,
  Text: WideString; Margin, Height, Opacity: Double; Alignment,
  IsHeader, RichText: Integer): Integer;

ActiveX

Function PDFlib::SetPageHeaderFooterVariant(SetName As String,
  VariantName As String, Text As String, Margin As Double,
  Height As Double, Opacity As Double, Alignment As Long,
  IsHeader As Long, RichText As Long) As Long

DLL

int DLSetPageHeaderFooterVariant(int InstanceID, const wchar_t* SetName,
  const wchar_t* VariantName, const wchar_t* Text, double Margin,
  double Height, double Opacity, int Alignment, int IsHeader, int RichText);
int DLSetPageHeaderFooterVariantA(int InstanceID, const char* SetName,
  const char* VariantName, const char* Text, double Margin,
  double Height, double Opacity, int Alignment, int IsHeader, int RichText);

Parametri

SetName	Nome senza distinzione tra maiuscole e minuscole condiviso dalle varianti appartenenti a un insieme di modelli
VariantName	`default`, `first`, `odd` o `even`, con corrispondenza senza distinzione tra maiuscole e minuscole
Text	Modello testo o HTML espanso separatamente per ogni pagina selezionata; un valore vuoto crea una variante vuota esplicita che impedisce il fallback
Margin	Distanza non negativa dal bordo della pagina pertinente
Height	Altezza del riquadro del contenuto oppure 0 per misurare automaticamente la riga di testo semplice o il contenuto HTML
Opacity	Valore da 0 per trasparente a 1 per opaco
Alignment	0 per sinistra, 1 per centro o 2 per destra
IsHeader	1 per un'intestazione o 0 per un piè di pagina
RichText	1 per eseguire il rendering di `Text` come HTML oppure 0 per usare il font e lo stato painter selezionati

Valori restituiti

Restituisce 1 se la variante è memorizzata oppure 0 per nome, variante, valore, allineamento o flag non validi

Note

Una chiamata successiva con gli stessi nomi di insieme e variante e lo stesso ruolo sostituisce la definizione

I modelli supportano gli stessi campi con e commerciale e <%name%> di AddPageHeader, incluse variabili personalizzate risolte da OnCalcVariable

Le definizioni appartengono all'istanza TPDFlib e possono essere applicate a più documenti

Esempio

PDF.SetPageHeaderFooterVariant('manual', 'first', '', 36, 0, 1, 0, 1, 0);
PDF.SetPageHeaderFooterVariant('manual', 'odd', 'Chapter — <%PageNo%>', 36, 0, 1, 2, 1, 0);
PDF.SetPageHeaderFooterVariant('manual', 'even', '<%PageNo%> — Chapter', 36, 0, 1, 0, 1, 0);