ApplyPageHeaderFooterSet

Disposition des pages, pagination, texte HTML

Description

Applique un ensemble nommé d'en-têtes et de pieds de page à une plage de pages avec sélection selon la première page et la parité physique des pages

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

Paramètres

SetName	Nom insensible à la casse précédemment enregistré avec SetPageHeaderFooterVariant
PageRange	Expression de plage de pages, ou chaîne vide pour toutes les pages

Valeurs de retour

Renvoie le nombre d'éléments non vides d'en-tête et de pied de page dessinés, ou 0 si l'ensemble ou la plage n'a pas de contenu applicable ou si la portée d'API ne peut pas changer de page

Remarques

Pour chaque rôle d’en-tête et de pied de page, la première page renvoyée par la plage utilise first s’il est défini ; les pages suivantes utilisent odd ou even selon leur numéro physique, et les variantes précises manquantes reviennent à default

Une variante vide explicitement définie ne trace rien et empêche le repli, ce qui permet des premières pages vides

Chaque modèle est développé pour sa page cible avant la mesure, et les variantes HTML utilisent le balisage développé pour calculer automatiquement la hauteur

Le contenu généré est marqué comme artefact de pagination, et la page, la police, l'état du peintre et le réglage de crénage sélectionnés par l'appelant sont rétablis

Exemple

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;