SetPageHeaderFooterVariant

Sidelayout, paginering, HTML-tekst

Beskrivelse

Opretter eller erstatter en variant i et navngivet genanvendeligt sæt med løbende sidehoveder og sidefødder

Syntaks

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

Parametre

SetName	Navn uden skelnen mellem store og små bogstaver, der deles af varianter, som tilhører ét skabelonsæt
VariantName	`default`, `first`, `odd` eller `even`, matchet uden forskel på store og små bogstaver
Text	Tekst- eller HTML-skabelon, der udvides separat for hver valgt side; en tom værdi opretter en eksplicit tom variant, som undertrykker reserveløsningen
Margin	Ikke-negativ afstand fra den relevante sidekant
Height	Indholdsboksens højde eller 0 for automatisk at måle den almindelige tekstlinje eller HTML-indholdet
Opacity	Værdi fra 0 for gennemsigtig til 1 for uigennemsigtig
Alignment	0 for venstre, 1 for centreret eller 2 for højre
IsHeader	1 for en sidehovedtekst eller 0 for en sidefodstekst
RichText	1 for at gengive `Text` som HTML eller 0 for at bruge den aktuelt valgte skrifttype og tegnetilstand

Returværdier

Returnerer 1, når varianten blev gemt, eller 0, når et navn, en variant, numerisk værdi, justering eller et flag er ugyldigt

Bemærkninger

Et senere kald med samme sætnavn, variantnavn og sidehoved- eller sidefodsrolle erstatter den eksisterende definition

Skabeloner understøtter de samme ampersand- og <%name%>-felter som AddPageHeader, herunder brugerdefinerede variabler, der opløses af OnCalcVariable

Definitioner tilhører TPDFlib-instansen og kan anvendes på mere end ét dokument

Eksempel

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