NewFormField
فیلدهای فرم
توضیحات
فیلد فرم جدیدی به صفحهٔ انتخابشده اضافه میکند
برای فیلدهای Text، Pushbutton، Checkbox، Choice و Signature، فیلد هم بهعنوان حاشیهنویسی Widget به صفحهٔ جاری متصل میشود و ارجاع صفحهٔ /P حاشیهنویسی میگیرد. چون /P حاشیهنویسی مدخلی از PDF 1.3 است، ساختن این فیلدها در سند PDF 1.2 خودکار PDF 1.3 را انتخاب میکند. فیلدهای امضا ممکن است وقتی پرچمهای امضای AcroForm تولیدشده لازمش داشته باشند همچنان به PDF 1.5 نیاز داشته باشند
نحو
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 = Text 2 = Pushbutton 3 = Checkbox 4 = Radiobutton 5 = Choice 6 = Signature 7 = Parent |
مقادیر بازگشتی
| 0 | فیلد فرم جدید ساخته نشد |
|---|---|
| Non-zero | فیلد فرم با موفقیت ساخته شد و این، شاخص فیلد جدید است |