THotPDF.SetPageLabel Method

Methodenzusammenfassung: THotPDF.SetPageLabel Method

Deklaration

procedure SetPageLabel(StartPageIndex: Integer; Style: THPDFPageLabelStyle; const Prefix: AnsiString = ''; StartNumber: Integer = 1);

HPDFDoc

Name	Zweck
`StartPageIndex`	Nullbasierter Seitenindex, bei dem der Bezeichnungsbereich beginnt
`Style`	Nummerierungsstil aus `THPDFPageLabelStyle`
`Prefix`	Optionaler Text vor jeder generierten Seitennummer
`StartNumber`	Erste logische Zahl dieses Bereichs, beginnend bei 1 oder höher

Die Methode schreibt bei EndDoc einen /PageLabels-Zahlenbaum in den Katalog des erzeugten PDF
Ein erneuter Aufruf mit demselben StartPageIndex ersetzt den früheren Bereich
Beginnt kein Bereich auf der ersten Seite, behalten die Seiten vor dem ersten Bereich schlichte dezimale Nummern, denn der Zahlenbaum muss den Seitenindex 0 abdecken (ISO 32000-1 12.4.2)
Ein Präfix mit Bytes über 127 wird als UTF-8 gelesen und als Unicode-Textstring gespeichert
Die aktive PDF-Version muss Seitenbezeichnungen unterstützen; HotPDF löst daher je nach StrictVersionLock eine Ausnahme aus oder validiert PDF 1.3
Seitenbezeichnungen ändern die Seitennummer-Anzeige des Viewers und sortieren Seiten nicht um