NewFormField

שדות טופס

תיאור

מוסיף שדה טופס חדש לעמוד הנבחר

עבור שדות Text, Pushbutton, Checkbox, Choice ו-Signature, השדה גם מחובר לעמוד הנוכחי כהערת Widget ומקבל הפניית עמוד /P של הערה. מכיוון ש-/P של הערה הוא רשומת PDF 1.3, יצירת השדות האלה במסמך PDF 1.2 בוחרת אוטומטית PDF 1.3. שדות חתימה עשויים עדיין לדרוש PDF 1.5 כשדגלי החתימה של ה-AcroForm שנוצרו דורשים זאת

תחביר

Delphi

Function TPDFlib.NewFormField(Const Title: WideString; FieldType: Integer): Integer;

ActiveX

Function PDFlib::NewFormField(Title As String, FieldType As Long) As Long

DLL

int DLNewFormField(int InstanceID, const wchar_t * Title, int FieldType);

פרמטרים

Title	הכותרת של שדה הטופס החדש. הכותרת לא יכולה להכיל את התו נקודה "."
FieldType	סוג השדה ליצירה: 1 = טקסט 2 = כפתור הדחיה 3 = תיבת סימון 4 = לחצן בחירה 5 = רשימת בחירה 6 = חתימה 7 = הורה

ערכי החזרה

0	לא ניתן היה ליצור את שדה הטופס החדש
Non-zero	שדה הטופס נוצר בהצלחה, וזהו האינדקס של השדה החדש