AddLinkToFileExA

Anotácie a aktívne odkazy

Opis

Koncové A označuje vstupný bod ANSI (char) knižnice DLL; rozhranie ActiveX/COM sprístupňuje iba formu Unicode. Správanie je rovnaké ako pri AddLinkToFileEx a reťazcové argumenty sa interpretujú pomocou aktuálnej znakovej stránky nastavenej funkciou SetAnsiMode

Pridáva na vybranú stránku klikateľný obdĺžnik hotspotu, ktorý odkazuje na konkrétnu stránku a pozíciu v inom PDF dokumente. Na zmenu farby okraja hotspotu použite funkciu SetAnnotBorderColor.

Odkaz na cieľový dokument je iba prostredníctvom názvu súboru. To znamená, že rozmery stránky cieľového dokumentu nie sú známe, takže parametre DestLeft, DestTop, DestRight a DestBottom sa vždy zadávajú v bodoch meraných od ľavého dolného rohu MediaBoxu cieľovej strany.

Syntax

Delphi

Function DLAddLinkToFileExA(InstanceID: Integer; Left, Top, Width, Height: Double; FileName: PAnsiChar; DestPage, NewWindow, Options, Zoom, DestType: Integer; DestLeft, DestTop, DestRight, DestBottom: Double): Integer;

DLL

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

Parametre

Left

Horizontálna súradnica ľavého okraja obdĺžnika hotspotu

Top

Zvislá súradnica horného okraja obdĺžnika hotspotu

Width

Šírka obdĺžnika hotspotu

Height

Výška obdĺžnika hotspotu

FileName

Cesta a názov súboru dokumentu PDF, na ktorý sa má odkazovať.

DestPage

Stránka v cieľovom dokumente, na ktorú sa má odkazovať

NewWindow

0 = Zatvorí aktuálny dokument a potom otvorí nový dokument

1 = Otvorí cieľový dokument v novom okne

Options

Určuje vzhľad odkazu:

0 = Bez orámovania

1 = Kresliť orámovanie

Percento priblíženia použité pre cieľový objekt, platné hodnoty od 0 do 6400. Používa sa iba pre DestType = 1, pre ostatné DestType by sa malo nastaviť na 0.

Zoom

DestType

1 = "XYZ" - cieľová strana je umiestnená v bode určenom parametrami Left a Top. Parameter Zoom určuje percento priblíženia.

2 = "Fit" - celá strana sa priblíži tak, aby sa zmestila do okna. Žiadne ďalšie parametre sa nepoužijú a mali by sa nastaviť na nulu.

3 = "FitH" - strana sa priblíži tak, aby bola viditeľná celá šírka strany. Výška strany môže byť väčšia alebo menšia než výška okna. Strana je umiestnená na zvislej pozícii určenej parametrom Top.

4 = "FitV" - strana sa priblíži tak, aby bola viditeľná celá výška strany. Šírka strany môže byť väčšia alebo menšia než šírka okna. Strana je umiestnená na vodorovnej pozícii určenej parametrom Left.

5 = "FitR" - strana sa priblíži tak, aby bola viditeľná určitá obdĺžniková oblasť na strane. Parametre Left, Top, Right a Bottom definujú obdĺžnikovú oblasť na strane.

6 = "FitB" - strana sa priblíži tak, aby bolo viditeľné jej ohraničujúce pole.

7 = "FitBH" - strana je zvislo umiestnená na pozícii určenej parametrom Top. Strana sa priblíži tak, aby bola viditeľná celá šírka jej ohraničujúceho poľa.

8 = "FitBV" - strana je umiestnená na vodorovnej pozícii určenej parametrom Left. Strana sa priblíži len natoľko, aby sa celá výška ohraničujúceho poľa zmestila do okna.

DestLeft

Vodorovná pozícia použitá pre DestType = 1, 4, 5 a 8

DestTop

Zvislá pozícia použitá pre DestType = 1, 3, 5 a 7

DestRight

Vodorovná pozícia pravého okraja obdĺžnika. Používa sa pre DestType = 5

DestBottom

Zvislá pozícia spodnej strany obdĺžnika. Používa sa pre DestType = 5