SetOutlineRemoteDestination

Marcaje

Descriere

Setează elementul de marcaj (bookmark) să deschidă alt PDF la clic

Se pot specifica numărul paginii de deschidere și diverse valori de dimensionare/poziționare

Notă: deoarece dimensiunea paginii documentului țintă nu este cunoscută, toate pozițiile sunt indicate în puncte, măsurate din colțul din stânga jos al paginii de deschidere

Sintaxă

Delphi

Function TPDFlib.SetOutlineRemoteDestination(OutlineID: Integer; Const FileName: WideString; OpenPage, Zoom, DestType: Integer; PntLeft, PntTop, PntRight, PntBottom: Double; NewWindow: Integer): Integer;

ActiveX

Function PDFlib::SetOutlineRemoteDestination(OutlineID As Long, FileName As String, OpenPage As Long, Zoom As Long, DestType As Long, PntLeft As Double, PntTop As Double, PntRight As Double, PntBottom As Double, NewWindow As Long) As Long

DLL

int DLSetOutlineRemoteDestination(int InstanceID, int OutlineID, const wchar_t * FileName, int OpenPage, int Zoom, int DestType, double PntLeft, double PntTop, double PntRight, double PntBottom, int NewWindow);

Parametri

OutlineID

ID-ul marcajului, returnat de funcția NewOutline. Alternativ, folosiți funcția GetOutlineID pentru a obține un ID de marcaj valid

FileName

Numele fișierului documentului PDF de deschis la clic pe marcaj. Trebuie să respecte un format anume: barele oblice inverse se convertesc în bare oblice normale, iar unitatea, dacă există, se indică doar ca literă între bare oblice, fără două puncte. De exemplu, fișierul "c:\my documents\hello.pdf" se specifică drept "/c/my documents/hello.pdf". Căile relative sunt valide, inclusiv căile cu operatorul ".." pentru urcarea unui director

OpenPage

Numărul paginii către care se sare la deschiderea documentului țintă. Prima pagină are indexul zero (0)

Zoom

Procentul de zoom folosit la deschiderea documentului, valori valide de la 0 la 6400. Folosit doar pentru DestType = 1; pentru celelalte DestTypes trebuie setat pe 0

DestType

1 = "XYZ" - pagina țintă este poziționată în punctul dat de parametrii Left și Top. Parametrul Zoom specifică procentul de zoom

2 = "Fit" - pagina întreagă este zoom-uită pentru a încăpea în fereastră. Ceilalți parametri nu sunt folosiți și trebuie setați pe zero

3 = "FitH" - pagina este zoom-uită astfel încât să fie vizibilă lățimea întreagă a paginii. Înălțimea paginii poate fi mai mare sau mai mică decât înălțimea ferestrei. Pagina este poziționată la verticală la poziția dată de parametrul Top

4 = "FitV" - pagina este zoom-uită astfel încât să fie vizibilă înălțimea întreagă a paginii. Lățimea paginii poate fi mai mare sau mai mică decât lățimea ferestrei. Pagina este poziționată la orizontală la poziția dată de parametrul Left

5 = "FitR" - pagina este zoom-uită astfel încât un anumit dreptunghi de pe pagină să fie vizibil. Parametrii Left, Top, Right și Bottom definesc zona dreptunghiulară de pe pagină

6 = "FitB" - pagina este zoom-uită astfel încât bounding box-ul să fie vizibil

7 = "FitBH" - pagina este poziționată vertical la poziția dată de parametrul Top. Pagina este zoom-uită astfel încât să fie vizibilă întreaga lățime a bounding box-ului paginii

8 = "FitBV" - pagina este poziționată la poziția orizontală dată de parametrul Left. Pagina este zoom-uită exact cât să încapă în fereastră întreaga înălțime a bounding box-ului

PntLeft

Poziția orizontală folosită de DestType = 1, 4, 5 și 8. Poziția este indicată în puncte, măsurate din colțul din stânga jos al paginii documentului țintă

PntTop

Poziția verticală folosită de DestType = 1, 3, 5 și 7. Poziția este indicată în puncte, măsurate din colțul din stânga jos al paginii documentului țintă

PntRight

Poziția orizontală a marginii drepte a dreptunghiului. Folosită de DestType = 5. Poziția este indicată în puncte, măsurate din colțul din stânga jos al paginii documentului țintă

PntBottom

Poziția orizontală a marginii de jos a dreptunghiului. Folosită de DestType = 5. Poziția este indicată în puncte, măsurate din colțul din stânga jos al paginii documentului țintă

NewWindow

0 = înlocuiește documentul curent cu documentul țintă

1 = deschide documentul țintă într-o fereastră nouă, cu excepția cazului în care utilizatorul a setat altă preferință în viewer-ul PDF

Valori returnate