THotPDF.AddLoadedTextField Method
מוסיף שדה טקסט לעמוד של המסמך הטעון ורושם אותו ב-AcroForm. השדה מקבל זרם מראה שמציג את הערך שלו, וה-AcroForm מקבל את גופן ברירת המחדל Helvetica שמחרוזת ה-/DA שלו מפנה אליו, כך שכל קורא יציג את השדה
הצהרה
function AddLoadedTextField(PageIndex: Integer; X1, Y1, X2, Y2: Single; const AFieldName, AValue: AnsiString; AMaxLen: Integer): Integer;
יחידה
HPDFDoc
פרמטרים
| שם | מטרה |
|---|---|
PageIndex | האינדקס מבוסס-האפס של העמוד הטעון שמקבל את ה-widget |
X1 | הקצה השמאלי של מלבן ה-widget במרחב המשתמש של PDF (נקודות, הראשית בפינה השמאלית-התחתונה של העמוד) |
Y1 | הקצה התחתון של מלבן ה-widget במרחב המשתמש של PDF |
X2 | הקצה הימני של מלבן ה-widget במרחב המשתמש של PDF |
Y2 | הקצה העליון של מלבן ה-widget במרחב המשתמש של PDF |
AFieldName | שם השדה החדש; השם לא יכול להופיע כבר בטופס הטעון |
AValue | הערך ההתחלתי; מחרוזת ריקה לשדה ריק |
AMaxLen | מספר התווים המרבי, או 0 ללא הגבלה |
ערך מוחזר
האינדקס של השדה החדש, לשימוש עם יתר מתודות שדות הטופס של המסמך הטעון, או -1 כאשר PageIndex מחוץ לטווח
הערות שימוש
- שמות השדות צריכים להישאר ייחודיים במסמך; שדות בשם זהה ישתפו ערך אחד בעת שליחת הטופס וידרסו זה את זה
- שדה חדש נוצר כברירת מחדל ללא כל הגדרת סגנון; אם נדרש מראה הכולל גבולות או צבע רקע, יש להגדיר זאת לאחר ההוספה באמצעות שיטות תכונות השדה
- לאחר הוספת השדה יש לשמור את המסמך כדי להתמיד את השינוי; האינדקס המוחזר תקף רק בפגישה הנוכחית, וייתכן שישתנה לאחר טעינת המסמך מחדש