SetDestProperties
הערות וקישורים חמים (hotspot links)
תיאור
Changes various properties of an existing destination.
תחביר
Delphi
Function TPDFlib.SetDestProperties(DestID, Zoom, DestType: Integer; Left, Top, Right, Bottom: Double): Integer;
ActiveX
Function PDFlib::SetDestProperties(DestID As Long, Zoom As Long, DestType As Long, Left As Double, Top As Double, Right As Double, Bottom As Double) As Long
DLL
int DLSetDestProperties(int InstanceID, int DestID, int Zoom, int DestType, double Left, double Top, double Right, double Bottom);
פרמטרים
| DestID | המזהה של היעד לניתוח. מזהה יעד תקין מוחזר על ידי הפונקציה GetOutlineDest |
|---|---|
| Zoom | אחוז הזום לשימוש בעת פתיחת יעד ה-outline, ערכים תקינים מ-0 עד 6400. בשימוש רק עבור DestType = 1; יש להגדיר ל-0 עבור שאר ה-DestTypes |
| DestType | 1 = "XYZ" - the target page is positioned at the point specified by the Left and Top parameters. The Zoom parameter specifies the zoom percentage. 2 = "Fit" - the entire page is zoomed to fit the window. None of the other parameters are used and should be set to zero. 3 = "FitH" - the page is zoomed so that the entire width of the page is visible. The height of the page may be greater or less than the height of the window. The page is positioned at the vertical position specified by the Top parameter. 4 = "FitV" - the page is zoomed so that the entire height of the page can be seen. The width of the page may be greater or less than the width of the window. The page is positioned at the horizontal position specified by the Left parameter. 5 = "FitR" - the page is zoomed so that a certain rectangle on the page is visible. The Left, Top, Right and Bottom parameters define the rectangular area on the page. 6 = "FitB" - the page is zoomed so that it's bounding box is visible. 7 = "FitBH" - the page is positioned vertically at the position specified by the Top parameter. The page is zoomed so that the entire width of the page's bounding box is visible. 8 = "FitBV" - the page is positioned at the horizontal position specified by the Left parameter. The page is zoomed just enough to fit the entire height of the bounding box into the window. The horizontal position used by DestType = 1, 4, 5 and 8 |
| Left | |
| Top | המיקום האנכי בשימוש עבור DestType = 1, 3, 5 ו-7 המיקום האופקי של הקצה הימני של המלבן. בשימוש עבור DestType = 5 |
| Right | |
| Bottom | המיקום האופקי של תחתית המלבן; בשימוש עבור DestType = 5 |
ערכי החזרה
| 0 | את מאפייני היעד לא ניתן היה להגדיר. ייתכן שהפרמטר DestID לא תקין או שהפרמטרים Zoom ו-DestType מחוץ לטווח |
|---|---|
| 1 | מאפייני היעד הוגדרו בהצלחה |