SetOutlineRemoteDestination

קווי מתאר

תיאור

מגדיר את פריט הסימניות (סימנייה) כך שיפתח PDF אחר בעת לחיצה עליו

אפשר לציין את מספר העמוד הפותח וערכי גודל/מיקום שונים

הערה: מאחר שגודל הדף של מסמך היעד אינו ידוע, כל המיקומים מצוינים בנקודות הנמדדות מהפינה השמאלית התחתונה של דף הפתיחה

תחביר

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

המזהה של ה-outline כפי שהוחזר מהפונקציה NewOutline. לחלופין, השתמשו בפונקציה GetOutlineID כדי לקבל מזהה outline חוקי

FileName

שם הקובץ של מסמך ה-PDF שייפתח בעת לחיצה על הסימנייה. עליו להיות בתבנית מסוימת. יש להמיר קווים נטויים לאחור לקווים נטויים קדימה, ואת הכונן, אם ישנו, יש לציין כאות הכונן בלבד בין קווים נטויים קדימה וללא נקודתיים. לדוגמה, יש לציין את הקובץ "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" - העמוד כולו מוגדל כדי להיכנס לחלון; אף אחד מהפרמטרים האחרים אינו בשימוש וצריך להגדיר אותם לאפס

3 = "FitH" - הדף מוגדל כך שכל רוחב הדף גלוי. גובה הדף עשוי להיות גדול או קטן מגובה החלון. הדף ממוקם במיקום האנכי שצוין בפרמטר Top

4 = "FitV" - העמוד מוגדל כך שכל גובהו נראה; רוחב העמוד עשוי להיות גדול או קטן מרוחב החלון; העמוד ממוקם במיקום האופקי שצוין בפרמטר Left

5 = "FitR" - העמוד מוגדל כך שמלבן מסוים בעמוד גלוי; הפרמטרים Left, Top, Right ו-Bottom מגדירים את האזור המלבני בעמוד

6 = "FitB" - העמוד מוגדל כך שתיבת התיחום שלו גלויה

7 = "FitBH" - העמוד ממוקם אנכית במיקום שצוין בפרמטר Top; העמוד מוגדל כך שכל רוחב תיבת התיחום של העמוד גלויה

8 = "FitBV" - העמוד ממוקם במיקום האופקי שצוין בפרמטר Left; העמוד מוגדל בדיוק עד כדי כך שכל גובה תיבת התיחום נכנס לחלון

PntLeft

המיקום האופקי בשימוש עבור DestType = 1, 4, 5 ו-8; המיקום מצוין בנקודות הנמדדות מהפינה התחתית השמאלית של עמוד מסמך היעד

PntTop

המיקום האנכי בשימוש עבור DestType = 1, 3, 5 ו-7; המיקום מצוין בנקודות הנמדדות מהפינה התחתית השמאלית של עמוד מסמך היעד

PntRight

המיקום האופקי של הקצה הימני של המלבן; בשימוש עבור DestType = 5; המיקום מצוין בנקודות הנמדדות מהפינה התחתית השמאלית של עמוד מסמך היעד

PntBottom

המיקום האופקי של תחתית המלבן; בשימוש עבור DestType = 5; המיקום מצוין בנקודות הנמדדות מהפינה התחתית השמאלית של עמוד מסמך היעד

NewWindow

0 = החלפת המסמך הנוכחי במסמך היעד

1 = פתיחת מסמך היעד בחלון חדש אלא אם המשתמש הגדיר העדפה אחרת במציג ה-PDF

ערכי החזרה