NewDestination
Adnotări și legături hotspot, Gestionarea documentelor
Descriere
Creează un obiect de destinație nou care poate fi utilizat cu funcțiile AddLinkToDestination, GetDestPage, GetDestType sau GetDestValue.
Sintaxă
Delphi
Function TPDFlib.NewDestination(DestPage, Zoom, DestType: Integer; Left, Top, Right, Bottom: Double): Integer;ActiveX
Function PDFlib::NewDestination(DestPage As Long, Zoom As Long, DestType As Long, Left As Double, Top As Double, Right As Double, Bottom As Double) As LongDLL
int DLNewDestination(int InstanceID, int DestPage, int Zoom, int DestType, double Left, double Top, double Right, double Bottom);Parametri
| DestPage | Numărul paginii către care trimite acest obiect destinație |
|---|---|
| Zoom | Procentul de zoom folosit pentru obiectul destinație, 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 |
| Left | Poziția orizontală folosită de DestType = 1, 4, 5 și 8 |
| Top | Poziția verticală folosită de DestType = 1, 3, 5 și 7 Poziția orizontală a marginii drepte a dreptunghiului. Folosită de DestType = 5 |
| Right | |
| Bottom | Poziția orizontală a marginii de jos a dreptunghiului. Folosită de DestType = 5 |
Valori returnate
| 0 | Parametrul DestPage era invalid O valoare DestID |
|---|---|
| Non-zero |