AddPageLabels

Właściwości strony

Opis

Dodaje zakres etykiet stron do wybranego dokumentu. Aby etykiety stron były wyświetlane prawidłowo, dokument musi zawierać zakres rozpoczynający się od strony 1. Etykiety stron są funkcją katalogu PDF 1.3; wywołanie tej metody dla dokumentu w niższej wersji podnosi efektywną wersję PDF do 1.3, chyba że wersja zapisu została jawnie zablokowana.

Gdy wczytany dokument przechowuje etykiety stron w drzewie numerycznym z węzłami potomnymi, istniejące zakresy etykiet pozostają zachowane; wstawienie lub zastąpienie zakresu nadal działa po zapisaniu i ponownym wczytaniu dokumentu

Składnia

Delphi

Function TPDFlib.AddPageLabels(Start, Style, Offset: Integer; Const Prefix: WideString): Integer;

ActiveX

Function PDFlib::AddPageLabels(Start As Long, Style As Long, Offset As Long, Prefix As String) As Long

DLL

int DLAddPageLabels(int InstanceID, int Start, int Style, int Offset, const wchar_t * Prefix);

Parametry

Start	Strona początkowa zakresu etykiet stron
Style	0 = Bez numerów 1 = Dziesiętne cyfry arabskie 2 = Wielkie cyfry rzymskie 3 = Małe cyfry rzymskie 4 = Wielkie litery (A do Z dla pierwszych 26 stron, AA do ZZ dla następnych 26 itd.) 5 = Małe litery (a do z dla pierwszych 26 stron, aa do zz dla następnych 26 itd.)
Offset	Wartość części liczbowej pierwszej etykiety strony w zakresie. Kolejne wartości będą numerowane sekwencyjnie od tej wartości, która musi być większa lub równa 1.
Prefix	Prefiks etykiet stron w tym zakresie.

Wartości zwracane

0	Parametr Style wykraczał poza zakres
1	Zakres etykiet stron został pomyślnie dodany