AddLinkToImportData
הערות וקישורי אזור לחיצה, שדות טופס ו-AcroForms
תיאור
מוסיף מלבן hotspot לחיץ לעמוד הנבחר, שמפעיל פעולת ייבוא-נתונים (import-data) של PDF בעת הפעלתו. פעולת ייבוא-נתונים ממלאה את שדות ה-AcroForm של המסמך מתוך קובץ Forms Data Format (FDF) בכונן. הפעולה מוגדרת ב-ISO 32000-1 §12.6.4.8, Table 198שימוש אופייני: קישור “טען מחדש נתוני דוגמה” או “אפס לברירות המחדל” בטופס אינטראקטיבי, שבו קובץ ה-FDF נשלח לצד ה-PDF ומכיל את ערכי השדות הקנונייםהשתמשו בפונקציה SetAnnotBorderColor כדי לשנות את צבע המסגרת של ה-hotspot
שימוש אופייני: קישור “Reload sample data” או “Reset to defaults” בטופס אינטראקטיבי, שבו קובץ ה-FDF נשלח לצד ה-PDF ומחזיק את ערכי השדות הקנוניים.
השתמשו בפונקציה SetAnnotBorderColor כדי לשנות את צבע גבול ה-hotspot.
תחביר
Delphi
Function TPDFlib.AddLinkToImportData(Left, Top, Width, Height: Double; Const FileName: WideString; Options: Integer): Integer;DLL
int DLAddLinkToImportData(int InstanceID, double Left, double Top, double Width, double Height, const wchar_t * FileName, int Options);פרמטרים
| Left | הקואורדינטה האופקית של הקצה השמאלי של מלבן ה-hotspot |
|---|---|
| Top | הקואורדינטה האנכית של הקצה העליון של מלבן ה-hotspot |
| Width | רוחב מלבן ה-hotspot |
| Height | גובה מלבן ה-hotspot |
| FileName | הנתיב לקובץ ה-FDF שממנו ימולאו שדות הטופס. לוכסנים אחוריים מומרים ללוכסנים קדמיים לפי תבנית הנתיב הקנונית של PDF ב-ISO 32000-1 §7.11.2.1. הקובץ אינו צריך להתקיים בעת יצירת ה-PDF, אך חייב להיות קיים בעת הצפייה כדי שהפעולה תצליח |
| Options | מסכת סיביות השולטת במראה הקישור. סיבית 0 (ערך 1): צייר מסגרת סביב מלבן ה-hotspot. סיביות 1–3 בוחרות את מצב ההדגשה בלחיצה (2 = Invert, 4 = Outline, 8 = Push); כאשר אף סיבית הדגשה אינה מוגדרת, נעשה שימוש ב-Invert כברירת מחדל. אותה מוסכמה כמו ב-AddLinkToWeb / AddLinkToHideField |
הערות
מצבי PDF/A ו-PDF/X-6 דוחים פעולות ImportData ומחזירים 0 מבלי להוסיף הערה; נדרש PDF 1.4 ומעלה