ApplyPageHeaderFooterSet

Sideoppsett, Paginering, HTML-tekst

Beskrivelse

Påfører et navngitt topp-/bunntekstsett på et sideområde med valg for førsteside og fysisk sidepartall

Syntaks

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

Parametere

SetName	Navn uten forskjell på store/små bokstaver, tidligere registrert med SetPageHeaderFooterVariant
PageRange	Sideområdeuttrykk, eller en tom streng for alle sider

Returverdier

Returnerer antall ikke-tomme topp- og bunnlinjeelementer tegnet, eller 0 når settet eller området ikke har noe anvendbart innhold eller gjeldende API-omfang ikke kan endre sider

Merknader

For hver topp- og bunntekstrolle bruker første side returnert av intervallet first når definert; senere sider bruker odd eller even etter sitt fysiske sidenummer, og manglende spesifikke varianter faller tilbake til default

En eksplisitt definert tom variant tegner ingenting og hindrer fallback, noe som støtter blanke første sider

Hver mal utvides mot målsiden før måling, og HTML-varianter bruker det utvidede markaupet for automatisk høydeberegning

Generert innhold merkes som et pagineringsartefakt, og kallerens valgte side, font, tegnertilstand og kerning-innstilling gjenopprettes

Eksempel

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;