AddLinkToSubmitForm

Annotations and hotspot links, Form fields and AcroForms

תיאור

מוסיף מלבן אזור חם לחיץ לדף הנבחר אשר מפעיל פעולת PDF של שליחת טופס בעת הפעלתו. פעולת שליחת טופס שולחת את ערכי שדות ה-AcroForm לכתובת URL או לנקודת קצה לעיבוד טפסים ללא צורך ב-JavaScript

השתמשו ב-FieldNames כדי להגביל את השדות הנשלחים. השאירו את FieldNames ריק כדי לאפשר למציג לשלוח את כל השדות הרלוונטיים

השתמשו בפונקציה SetAnnotBorderColor כדי לשנות את צבע הגבול של האזור החם

תחביר

Delphi

Function TPDFlib.AddLinkToSubmitForm(Left, Top, Width, Height: Double; Const URL, FieldNames: WideString; Flags, Options: Integer): Integer;

DLL

int DLAddLinkToSubmitForm(int InstanceID, double Left, double Top, double Width, double Height, const wchar_t * URL, const wchar_t * FieldNames, int Flags, int Options);

פרמטרים

Leftהקואורדינטה האופקית של הקצה השמאלי של מלבן האזור החם.
Topהקואורדינטה האנכית של הקצה העליון של מלבן האזור החם.
Widthהרוחב של מלבן האזור החם.
Heightהגובה של מלבן האזור החם.
URLכתובת ה-URL של יעד השליחה המאוחסנת במפרט קובץ הפעולה
FieldNamesרשימה אופציונלית של שמות שדות AcroForm מלאים מופרדים בפסיקים, נקודה ופסיק או מעברי שורה. רווחים לבנים מובילים ונגררים סביב כל שם נחתכים
Flagsדגלי פעולת שליחת טופס של PDF הנכתבים לערך /Flags של הפעולה; העבירו 0 להתנהגות ברירת המחדל בסגנון FDF; סיביות סטנדרטיות נפוצות כוללות 4 עבור פורמט HTML, 32 עבור XFDF ו-256 לשליחת מסמך ה-PDF השלם
Optionsמסכת סיביות השולטת במראה הקישור. סיבית 0 (ערך 1): ציירו גבול סביב מלבן האזור החם. סיביות 1-3 בוחרות את מצב הדגשת הלחיצה (2 = Invert, 4 = Outline, 8 = Push); כאשר לא מוגדרת סיבית הדגשה, Invert משמש כברירת מחדל

ערכי החזרה

0הפעולה לא נוספה מכיוון שהמסמך נמצא במצב PDF/A, המלבן אינו חוקי או ש-URL ריק
1הערת הקישור ופעולת שליחת הטופס נוספו.

הערות

מצב PDF/A חוסם פעולה זו מכיוון שהיא יכולה להפנות ליעד שליחה חיצוני. הפונקציה דורשת PDF 1.2 או גרסה מאוחרת יותר