ApplyPageHeaderFooterSet

Rozvržení stránek, stránkování, text HTML

Popis

Aplikuje pojmenovanou sadu záhlaví a zápatí na rozsah stránek s výběrem podle první stránky a parity fyzických stránek

Syntaxe

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

Parametry

SetName	Název nerozlišující velikost písmen dříve registrovaný přes SetPageHeaderFooterVariant
PageRange	Výraz rozsahu stránek, nebo prázdný řetězec pro všechny stránky

Návratové hodnoty

Vrací počet nakreslených neprázdných elementů záhlaví a zápatí, nebo 0, když sada nebo rozsah nemá použitelný obsah nebo aktuální rozsah API nemůže měnit stránky

Poznámky

U každé role záhlaví a zápatí použije první stránka vrácená rozsahem first, když je definováno; pozdější stránky používají odd nebo even podle svého fyzického čísla stránky a chybějící specifické varianty spadnou na default

Explicitně definovaná prázdná varianta nic nekreslí a brání náhradě, což podporuje prázdné první stránky

Každá šablona se rozvine proti své cílové stránce před měřením a HTML varianty používají rozvinuté označení pro automatický výpočet výšky

Generovaný obsah se označí jako artefakt stránkování a obnoví se vybraná stránka, font, stav kresliče a nastavení kerningu volajícího

Příklad

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;