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 LongDLL
int DLNewFormField(int InstanceID, const wchar_t * Title, int FieldType);المعاملات
| Title | عنوان حقل النموذج الجديد. ولا يمكن أن يتضمن العنوان محرف النقطة "." |
|---|---|
| FieldType | نوع الحقل المطلوب إنشائه: 1 = نص 2 = زر ضغط 3 = مربع اختيار 4 = زر اختيار (radio) 5 = قائمة اختيار 6 = توقيع 7 = أب |
قيم الإرجاع
| 0 | تعذّر إنشاء حقل النموذج الجديد |
|---|---|
| Non-zero | أُنشئ حقل النموذج بنجاح، وهذا هو فهرس الحقل الجديد |