ApplyPageHeaderFooterSet

Макет страницы, разбивка на страницы, HTML-текст

Описание

Применяет именованный набор колонтитулов к диапазону страниц с выбором первой страницы и четности физической страницы

Синтаксис

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

Параметры

SetName	Имя без учета регистра, ранее зарегистрированное через SetPageHeaderFooterVariant
PageRange	Выражение диапазона страниц или пустая строка для всех страниц

Возвращаемые значения

Возвращает число непустых нарисованных элементов колонтитулов либо 0, если у набора или диапазона нет применимого содержимого либо текущая область API не может менять страницы

Примечания

Для каждой роли колонтитула первая страница диапазона использует first, если он определен; последующие страницы используют odd или even по своему физическому номеру, а отсутствующие конкретные варианты откатываются к defaultЯвно определенный пустой вариант ничего не рисует и блокирует откат, что поддерживает пустые первые страницы

Каждый шаблон разворачивается по своей целевой странице до измерения, а HTML-варианты используют развёрнутую разметку для автоматического расчёта высоты

Каждый шаблон разворачивается по своей целевой странице до измерения, а варианты HTML используют развернутую разметку для автоматического вычисления высоты

Сгенерированное содержимое помечается как артефакт пагинации, а выбранная вызывающим кодом страница, шрифт, состояние рисовальщика и настройка кернинга восстанавливаются

Пример

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;