AddRelativeLinkToFileEx

Adnotacje i łącza obszarów aktywnych

Opis

Dodaje do wybranej strony klikalny prostokątny obszar aktywny, który za pomocą ścieżki względnej prowadzi do określonej strony i pozycji w innym dokumencie PDF. Użyj funkcji SetAnnotBorderColor, aby zmienić kolor obramowania obszaru aktywnego.

Łącze do dokumentu docelowego używa wyłącznie nazwy pliku. Oznacza to, że wymiary stron dokumentu docelowego nie są znane, dlatego parametry DestLeft, DestTop, DestRight i DestBottom są zawsze podawane w punktach mierzonych od lewego dolnego narożnika MediaBox strony docelowej'

Składnia

Delphi

Function TPDFlib.AddRelativeLinkToFileEx(Left, Top, Width, Height: Double; Const FileName: WideString; DestPage: Integer; NewWindow, Options, Zoom, DestType: Integer; DestLeft, DestTop, DestRight, DestBottom: Double): Integer;

ActiveX

Function PDFlib::AddRelativeLinkToFileEx(Left As Double, Top As Double, Width As Double, Height As Double, FileName As String, DestPage As Long, NewWindow As Long, Options As Long, Zoom As Long, DestType As Long, DestLeft As Double, DestTop As Double, DestRight As Double, DestBottom As Double) As Long

DLL

int DLAddRelativeLinkToFileEx(int InstanceID, double Left, double Top, double Width, double Height, const wchar_t * FileName, int DestPage, int NewWindow, int Options, int Zoom, int DestType, double DestLeft, double DestTop, double DestRight, double DestBottom);

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

FileName

Pełna ścieżka bezwzględna i nazwa pliku dokumentu PDF, do którego prowadzi łącze; zostanie przekształcona w ścieżkę względną

DestPage

Strona w dokumencie docelowym, do której prowadzi łącze

NewWindow

0 = Zamknij bieżący dokument, a następnie otwórz nowy dokument

1 = Otwórz bieżący dokument w nowym oknie

Options

Określa wygląd łącza:

0 = Bez obramowania

1 = Rysuj obramowanie

Procent powiększenia używany dla obiektu docelowego; prawidłowe wartości wynoszą od 0 do 6400. Używany tylko dla DestType = 1, a dla innych wartości DestType powinien wynosić 0

Zoom

DestType

1 = "XYZ" - strona docelowa jest ustawiana w punkcie określonym przez parametry Left i Top. Parametr Zoom określa procent powiększenia

2 = "Fit" - cała strona jest skalowana tak, aby zmieściła się w oknie. Pozostałe parametry nie są używane i należy ustawić je na zero

3 = "FitH" - skala strony jest dobierana tak, aby widoczna była cała szerokość strony. Wysokość strony może być większa lub mniejsza od wysokości okna. Strona jest ustawiana w pionowej pozycji określonej przez parametr Top

4 = "FitV" - skala strony jest dobierana tak, aby widoczna była cała wysokość strony. Szerokość strony może być większa lub mniejsza od szerokości okna. Strona jest ustawiana w poziomej pozycji określonej przez parametr Left

5 = "FitR" - skala strony jest dobierana tak, aby był widoczny określony prostokąt strony. Parametry Left, Top, Right i Bottom definiują prostokątny obszar strony

6 = "FitB" - skala strony jest dobierana tak, aby widoczny był jej prostokąt ograniczający'

7 = "FitBH" - strona jest ustawiana w pionowej pozycji określonej przez parametr Top. Skala strony jest dobierana tak, aby widoczna była cała szerokość prostokąta ograniczającego stronę'

8 = "FitBV" - strona jest ustawiana w poziomej pozycji określonej przez parametr Left. Skala strony jest dobierana tak, aby w oknie zmieściła się cała wysokość prostokąta ograniczającego

DestLeft

Położenie poziome używane przez DestType = 1, 4, 5 i 8

DestTop

Położenie pionowe używane przez DestType = 1, 3, 5 i 7

DestRight

Pozioma pozycja prawej krawędzi prostokąta. Używana, gdy DestType = 5

DestBottom

Pozioma pozycja dolnej krawędzi prostokąta. Używana, gdy DestType = 5

int NewWindow, int Options, int Zoom, int DestType, double DestLeft, double DestTop, double DestRight, double DestBottom);

Height: Double; FileName: WideString; DestPage, NewWindow, Options, Zoom, DestType: Integer; DestLeft, DestTop, DestRight,