ApplyPageHeaderFooterSet

Diseño de página, paginación, texto HTML

Descripción

Aplica un conjunto con nombre de encabezados y pies de página a un intervalo de páginas, con selección según la primera página y la paridad de la página física

Sintaxis

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

Parámetros

SetName	Nombre sin distinción entre mayúsculas y minúsculas registrado previamente mediante SetPageHeaderFooterVariant
PageRange	Expresión de intervalo de páginas, o una cadena vacía para todas las páginas

Valores devueltos

Devuelve el número de elementos de cabecera y pie no vacíos dibujados, o 0 si no hay contenido aplicable o el ámbito actual no puede cambiar páginas

Observaciones

Para cada función de encabezado y pie, la primera página devuelta por el intervalo utiliza first cuando está definido; las páginas posteriores utilizan odd o even según su número físico, y las variantes específicas ausentes recurren a default

Una variante vacía definida explícitamente no dibuja nada e impide recurrir a otra variante, lo que permite páginas iniciales en blanco

Cada plantilla se expande con respecto a su página de destino antes de medirla y las variantes HTML usan el marcado expandido para calcular automáticamente la altura

El contenido generado se marca como artefacto de paginación y se restauran la página, la fuente, el estado del pintor y la configuración de interletraje seleccionados por el llamador

Ejemplo

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;