THotPDF.SetPageLabel Method
Сводка метода: THotPDF.SetPageLabel Method
Объявление
procedure SetPageLabel(StartPageIndex: Integer; Style: THPDFPageLabelStyle; const Prefix: AnsiString = ''; StartNumber: Integer = 1);
Модуль
HPDFDoc
Параметры
| Имя | Назначение |
|---|---|
StartPageIndex | Индекс страницы с нулевой базой, с которого начинается диапазон меток |
Style | Стиль нумерации из THPDFPageLabelStyle |
Prefix | Необязательный текст, вставляемый перед каждым сгенерированным номером страницы |
StartNumber | Первый логический номер этого диапазона, начиная с 1 или выше |
Примечания по использованию
- Метод записывает number tree
/PageLabelsв каталог, когдаEndDocфинализирует генерируемый PDF - Повторный вызов метода с тем же
StartPageIndexзамещает прежний диапазон - Когда ни один диапазон не начинается на первой странице, страницы до первого диапазона сохраняют простые десятичные номера: number tree должен покрывать страницу с индексом 0 (ISO 32000-1 12.4.2)
- Префикс с байтами выше 127 читается как UTF-8 и сохраняется как строка Unicode
- Активная версия PDF должна поддерживать метки страниц, поэтому HotPDF выбрасывает исключение или валидирует PDF 1.3 в соответствии с
StrictVersionLock - Метки страниц меняют отображение номеров страниц в viewer и не переупорядочивают страницы
Related API
- THPDFPageLabelStyle Type
- THotPDF.ClearPageLabels Method