AddLinkToNamedAction

Adnotacje i łącza obszarów aktywnych, Właściwości strony

Opis

Dodaje do wybranej strony klikalny prostokątny obszar aktywny, który po aktywacji wyzwala nazwaną akcję PDF. Nazwane akcje to sterowane przez przeglądarkę polecenia nawigacji zdefiniowane w ISO 32000-1 §12.6.4.11, tabela 194. Obsługiwane są cztery standardowe nazwy: NextPage, PrevPage, FirstPage i LastPage. W odróżnieniu od AddLinkToPage nie jest wymagany jawny numer strony docelowej — przeglądarka interpretuje polecenie w czasie wykonywania.

Typowe zastosowanie: przyciski nawigacji (Dalej / Wstecz / Początek / Koniec) w nagłówku lub stopce strony, gdy miejsce docelowe jest względne wobec strony aktualnie wyświetlanej przez przeglądarkę.

Aby zmienić kolor obramowania obszaru aktywnego, użyj funkcji SetAnnotBorderColor

Składnia

Delphi

Function TPDFlib.AddLinkToNamedAction(Left, Top, Width, Height: Double; NamedActionType: Integer; Options: Integer): Integer;

DLL

int DLAddLinkToNamedAction(int InstanceID, double Left, double Top, double Width, double Height, int NamedActionType, int Options);

Parametry

Left	Pozioma współrzędna lewej krawędzi prostokąta obszaru aktywnego
Top	Pionowa współrzędna górnej krawędzi prostokąta obszaru aktywnego
Width	Szerokość prostokąta obszaru aktywnego
Height	Wysokość prostokąta obszaru aktywnego
NamedActionType	Wybiera nazwaną akcję do wyzwolenia: 0 = NextPage, 1 = PrevPage, 2 = FirstPage, 3 = LastPage. Wartości spoza tego zakresu używają NextPage, dzięki czemu moduł zapisujący zawsze emituje zgodną ze specyfikacją nazwę /N.
Options	Maska bitowa sterująca wyglądem łącza. Bit 0 (wartość 1): narysuj obramowanie wokół prostokąta obszaru aktywnego. Bity 1–3 wybierają tryb wyróżnienia kliknięcia (2 = Invert, 4 = Outline, 8 = Push); gdy nie ustawiono żadnego bitu wyróżnienia, domyślnie używany jest Invert. Ta sama konwencja co w AddLinkToWeb / AddLinkToPage.

Uwagi

Adnotacja jest zgodna z PDF/A, ponieważ nie odwołuje się do zasobu zewnętrznego. Wymagany jest PDF 1.1 lub nowszy.