NewFormFieldA
حقول النماذج
الوصف
تشير اللاحقة A إلى نقطة دخول DLL بصيغة ANSI (char)؛ وتبقى واجهة ActiveX/COM مكشوفةً بالصيغة Unicode فقط. والسلوك مطابق لـ NewFormField وتُفسر وسائط السلاسل بصفحة شيفرة SetAnsiMode الحالية
يضيف حقل نموذج جديدًا إلى الصفحة المحددة كابن لحقل آخر
بالنسبة لحقول Text وPushbutton وCheckbox وChoice وSignature يُلحق الحقل أيضًا بالصفحة الحالية كتعليق توضيحي من نوع Widget ويتلقى مرجع صفحة /P للتعليق التوضيحي. ولأن مدخل /P الخاص بالتعليقات التوضيحية هو مدخل PDF 1.3، فإن إنشاء هذه الحقول في مستند PDF 1.2 يختار PDF 1.3 تلقائيًا. وقد تظل حقول التوقيع تتطلب PDF 1.5 عندما تتطلب ذلك أعلام توقيع AcroForm المولدة
الصيغة
Delphi
Function DLNewFormFieldA(InstanceID: Integer; Title: PAnsiChar; FieldType: Integer): Integer;
DLL
int DLNewFormFieldA(int InstanceID, const char * Title, int FieldType);
المعاملات
| Title | عنوان حقل النموذج الجديد. ولا يمكن أن يتضمن العنوان محرف النقطة "." |
|---|---|
| FieldType | نوع الحقل المطلوب إنشائه: 1 = نص 2 = زر ضغط 3 = مربع اختيار 4 = زر اختيار (radio) 5 = قائمة اختيار 6 = توقيع 7 = أب |
قيم الإرجاع
| 0 | تعذّر إنشاء حقل النموذج الجديد |
|---|---|
| Non-zero | أُنشئ حقل النموذج بنجاح، وهذا هو فهرس الحقل الجديد |