SetOutlineRemoteDestination

Διάρθρωση

Περιγραφή

Ορίζει το στοιχείο outline (bookmark) να ανοίγει άλλο PDF όταν γίνει κλικ

Ο αριθμός της σελίδας ανοίγματος και διάφορες τιμές μεγέθους/θέσης μπορούν να καθοριστούν

Σημείωση: επειδή το μέγεθος σελίδας του εγγράφου προορισμού είναι άγνωστο, όλες οι θέσεις καθορίζονται σε points με μέτρηση από την κάτω αριστερή γωνία της αρχικής σελίδας

Σύνταξη

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);

Παράμετροι

OutlineID

Το ID του outline όπως επιστρέφεται από τη συνάρτηση NewOutline. Εναλλακτικά, χρησιμοποιήστε τη συνάρτηση GetOutlineID για να λάβετε ένα έγκυρο ID outline

FileName

Το όνομα αρχείου του εγγράφου PDF που θα ανοίξει όταν γίνει κλικ στο outline. Πρέπει να έχει συγκεκριμένη μορφή. Οι ανάστροφες κάθετοι πρέπει να μετατραπούν σε καθέτους και η μονάδα δίσκου, αν υπάρχει, πρέπει να δηλώνεται μόνο με το γράμμα της ανάμεσα σε καθέτους, χωρίς άνω και κάτω τελεία. Για παράδειγμα, το αρχείο "c:\my documents\hello.pdf" πρέπει να δηλώνεται ως "/c/my documents/hello.pdf". Τα σχετικά ονόματα διαδρομών είναι έγκυρα, συμπεριλαμβανομένων διαδρομών που περιέχουν τον τελεστή ".." για μετάβαση σε γονικό κατάλογο

OpenPage

Ο αριθμός σελίδας προς μετάβαση όταν ανοίγει το έγγραφο προορισμού. Η πρώτη σελίδα έχει δείκτη μηδέν (0)

Zoom

Το ποσοστό ζουμ όταν ανοίγει το έγγραφο, έγκυρες τιμές από 0 έως 6400. Χρησιμοποιείται μόνο για DestType = 1, για τους άλλους DestTypes πρέπει να είναι 0

DestType

1 = "XYZ" - η σελίδα προορισμού τοποθετείται στο σημείο που ορίζουν οι παράμετροι Left και Top. Η παράμετρος Zoom ορίζει το ποσοστό ζουμ

2 = "Fit" - ολόκληρη η σελίδα κλιμακώνεται ώστε να χωράει στο παράθυρο. Καμία από τις άλλες παραμέτρους δεν χρησιμοποιείται και πρέπει να οριστούν στο 0

3 = "FitH" — η σελίδα μεγεθύνεται ώστε να είναι ορατό όλο το πλάτος της. Το ύψος της σελίδας μπορεί να είναι μεγαλύτερο ή μικρότερο από το ύψος του παραθύρου. Η σελίδα τοποθετείται στην κατακόρυφη θέση που καθορίζεται από την παράμετρο Top

4 = "FitV" - η σελίδα κλιμακώνεται ώστε να φαίνεται όλο το ύψος της. Το πλάτος της σελίδας μπορεί να είναι μεγαλύτερο ή μικρότερο από το πλάτος του παραθύρου. Η σελίδα τοποθετείται στην οριζόντια θέση που ορίζει η παράμετρος Left

5 = "FitR" - η σελίδα κλιμακώνεται ώστε να είναι ορατό ένα συγκεκριμένο ορθογώνιο της σελίδας. Οι παράμετροι Left, Top, Right και Bottom καθορίζουν την ορθογώνια περιοχή στη σελίδα

6 = "FitB" - η σελίδα κλιμακώνεται ώστε να είναι ορατό το bounding box της

7 = "FitBH" - η σελίδα τοποθετείται κατακόρυφα στη θέση που ορίζει η παράμετρος Top. Η σελίδα κλιμακώνεται ώστε να φαίνεται όλο το πλάτος του bounding box της

8 = "FitBV" - η σελίδα τοποθετείται στην οριζόντια θέση που ορίζει η παράμετρος Left. Η σελίδα κλιμακώνεται ακριβώς όσο χρειάζεται για να χωράει όλο το ύψος του bounding box στο παράθυρο

PntLeft

Η οριζόντια θέση που χρησιμοποιείται από DestType = 1, 4, 5 και 8. Η θέση ορίζεται σε points μετρημένα από την κάτω αριστερή γωνία της σελίδας του εγγράφου προορισμού

PntTop

Η κατακόρυφη θέση που χρησιμοποιείται από DestType = 1, 3, 5 και 7. Η θέση ορίζεται σε points μετρημένα από την κάτω αριστερή γωνία της σελίδας του εγγράφου προορισμού

PntRight

Η οριζόντια θέση της δεξιάς πλευράς του ορθογωνίου. Χρησιμοποιείται από DestType = 5. Η θέση ορίζεται σε points μετρημένα από την κάτω αριστερή γωνία της σελίδας του εγγράφου προορισμού

PntBottom

Η οριζόντια θέση της βάσης του ορθογωνίου. Χρησιμοποιείται από DestType = 5. Η θέση ορίζεται σε points μετρημένα από την κάτω αριστερή γωνία της σελίδας του εγγράφου προορισμού

NewWindow

0 = Αντικατάσταση του τρέχοντος εγγράφου με το έγγραφο προορισμού

1 = Άνοιγμα του εγγράφου προορισμού σε νέο παράθυρο, εκτός αν ο χρήστης έχει ορίσει διαφορετική προτίμηση στο PDF viewer

Τιμές επιστροφής