ApplyPageHeaderFooterSet

Sidelayout, paginering, HTML-tekst

Beskrivelse

Anvender et navngivet sæt af sidehoved og sidefod på et sideinterval med valg efter første side og fysiske siders paritet

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

Parametre

SetName	Navn uden forskel på store og små bogstaver, som tidligere er registreret med SetPageHeaderFooterVariant
PageRange	Sideintervaludtryk eller en tom streng for alle sider

Returværdier

Returnerer antallet af ikke-tomme sidehoved- og sidefodselementer, der er tegnet, eller 0, når sættet eller området ikke har anvendeligt indhold, eller det aktuelle API-omfang ikke kan skifte side

Bemærkninger

For hver sidehoved- og sidefodsrolle bruger den første side, som intervallet returnerer, first, når den er defineret; senere sider bruger odd eller even i henhold til deres fysiske sidenummer, og manglende specifikke varianter falder tilbage til default

En eksplicit defineret tom variant tegner intet og forhindrer reserveadfærd, hvilket understøtter tomme førstesider

Hver skabelon udfoldes mod sin målside før måling, og HTML-varianter bruger den udfoldede markup til automatisk højdeberegning

Genereret indhold markeres som et pagineringsartefakt, og kalderens valgte side, skrifttype, malertilstand og knibningsindstilling gendannes

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;