SetPageHeaderFooterVariant

Pagina-indeling, paginering, HTML-tekst

Beschrijving

Maakt één variant aan of vervangt die in een benoemde, herbruikbare set doorlopende kop- en voetteksten

Syntaxis

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);

Parameters

SetName	Case-insensitive name shared by variants that belong to one template set
VariantName	`default`, `first`, `odd`, or `even`, matched case-insensitively
Text	Tekst- of HTML-sjabloon dat per geselecteerde pagina apart wordt uitgebreid; een lege waarde maakt een expliciete lege variant die fallback onderdrukt
Margin	Niet-negatieve afstand vanaf de betreffende paginarand
Height	Content-box-hoogte, of 0 om de platte-tekstregel of HTML-inhoud automatisch te meten
Opacity	Waarde van 0 (transparant) tot 1 (ondoorzichtig)
Alignment	0 for left, 1 for centre, or 2 for right
IsHeader	1 for a header or 0 for a footer
RichText	1 om `Text` als HTML te renderen, of 0 om het momenteel geselecteerde font en de painter-status te gebruiken

Retourwaarden

Geeft 1 terug wanneer de variant is opgeslagen, of 0 wanneer een naam, variant, numerieke waarde, uitlijning of vlag ongeldig is

Opmerkingen

Een latere aanroep met dezelfde setnaam, variantnaam en dezelfde kop- of voetrol vervangt de bestaande definitie

Templates ondersteunen dezelfde ampersand- en <%name%>-velden als AddPageHeader, inclusief custom variabelen die door OnCalcVariable worden geresolveerd Definities horen bij de

TPDFlib-instantie en kan op meer dan één document worden toegepast

Voorbeeld

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);