THotPDF.CreateLoadedFieldWidget Method
בדף שצוין ב-PDF הנטען, עם השם הנתון והמלבן המיקום, יוצר מילון פקד שדה טופס חדש לצירוף פקד טופס אינטראקטיבי למסמך ה-PDF הקיים
הצהרה
function CreateLoadedFieldWidget(PageIndex: Integer; const AFieldName: AnsiString; ARect: THPDFRect): THPDFDictionaryObject;יחידה
HPDFDoc
פרמטר
| שם | שימוש |
|---|---|
PageIndex | האינדקס של העמוד היעד (מתחיל מאפס), אשר בו יושב הפקד |
AFieldName | יצירת זהות עבור שדה-ממוחשב אשר נוצר באותו המסמך. איסור ליצור שתי-כתובות באותו ה-PDF תחת שמם וזהותם מתוך ניסיון-הימנעות בכפילויות |
ARect | המיקום וממדי המלבן של הפקד על העמוד, בשימוש במערכת קואורדינטות של ה-PDF (נקודת האפס ממוקמת בפינה השמאלית התחתונה של העמוד) |
X2 | קלט בשימוש CreateLoadedFieldWidget |
Y2 | קלט בשימוש CreateLoadedFieldWidget |
AFieldName | שם שדה AcroForm או מילון שדה שהעזר מכוון אליו |
AFieldType | שם שדה AcroForm או מילון שדה שהעזר מכוון אליו |
AFlags | קלט בשימוש CreateLoadedFieldWidget |
ערך מוחזר
מחזיר את THPDFDictionaryObject המייצג את פקד השדה החדש; אפשר להמשיך ולהגדיר את תכונותיו — סוג השדה, ערך ברירת מחדל, מראה ועוד
הערות שימוש
- לפני קריאה למתודה זו יש לקרוא ל-EnsureLoadedAcroForm כדי להבטיח שלמסמך יש מילון AcroForm; אחרת רישום השדה עלול להיכשל
- ה-AFieldName חייב להיות ייחודי בכל המסמך; שם כפול גורם להתנגשות נתוני טופס או להתנהגות לא עקבית בקוראים
- אובייקט המילון המוחזר מנוהל על ידי מחזור החיים של המסמך; אין על הגורם הקורא לשחרר את אובייקט המילון, וההפניות לאובייקט זה יבוטלו לאחר שמירת המסמך