ApplyPageHeaderFooterSet

Pagina-indeling, paginering, HTML-tekst

Beschrijving

Past een benoemde kop- en voettekstset toe op een paginabereik met selectie op eerste pagina en fysieke paginaparity

Syntaxis

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

Parameters

SetName	Hoofdletterongevoelige naam die eerder is geregistreerd met SetPageHeaderFooterVariant
PageRange	Paginabereikexpressie, of een lege string voor elke pagina

Retourwaarden

Geeft het aantal getekende niet-lege kop- en voettekstelementen terug, of 0 wanneer de set of het bereik geen toepasbare inhoud heeft of de huidige API-scope geen pagina's mag wisselen

Opmerkingen

Voor elke kop- en voetrol gebruikt de eerste pagina die het bereik teruggeeft first indien gedefinieerd; latere pagina's gebruiken odd of even naar hun fysieke paginanummer, en ontbrekende specifieke varianten vallen terug op default Een expliciet gedefinieerde lege variant tekent niets en voorkomt terugval, wat lege eerste pagina's ondersteunt

Elke template wordt vóór de meting uitgevouwen tegen zijn doelpagina, en HTML-varianten gebruiken de uitgevouwen markup voor de automatische hoogteberekening

Gegenereerde inhoud wordt gemarkeerd als paginering-artifact en de door de aanroeper geselecteerde pagina, het font, de painter-status en de kerninginstelling worden hersteld

Voorbeeld

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;