THotPDF.CreateLoadedFieldWidget Method
في الصفحة المحددة من PDF المُحمّل، ينشئ قاموس تحكم حقل نموذج جديد باسم الحقل والمستطيل المحددين للموقع، ويُستخدم لإلحاق عناصر تحكم نموذج تفاعلية بمستند PDF الموجود
الإعلان
function CreateLoadedFieldWidget(PageIndex: Integer; const AFieldName: AnsiString; ARect: THPDFRect): THPDFDictionaryObject;وحدة
HPDFDoc
المعاملات
| الاسم | الغرض |
|---|---|
PageIndex | فهرس الصفحة الهدف الذي يبدأ من الصفر، يحدد صفحة الأداة |
AFieldName | الاسم الفريد للحقل الجديد، ولا يجوز أن يطابق اسم حقل قائم في المستند نفسه |
ARect | مستطيل موضع الأداة وحجمها على الصفحة، بنظام إحداثيات PDF (ذي المبدأ في الزاوية السفلية اليسرى) |
X2 | مُدخَل يستخدمه CreateLoadedFieldWidget |
Y2 | مُدخَل يستخدمه CreateLoadedFieldWidget |
AFieldName | اسم حقل AcroForm أو قاموس الحقل الذي يستهدفه المساعد |
AFieldType | اسم حقل AcroForm أو قاموس الحقل الذي يستهدفه المساعد |
AFlags | مُدخَل يستخدمه CreateLoadedFieldWidget |
القيمة المُعادة
يعيد THPDFDictionaryObject يمثل أداة الحقل المُنشأة حديثًا، ويمكن بعدها ضبط نوع الحقل والقيمة الافتراضية والمظهر وغيرها من الخصائص
ملاحظات الاستخدام
- استدعِ EnsureLoadedAcroForm قبل هذا التابع لضمان امتلاك المستند قاموس AcroForm، وإلا قد يفشل تسجيل الحقل
- يجب أن يبقى AName فريدًا على مستوى المستند كله؛ فتشابه الأسماء يسبب تعارضًا في بيانات النموذج أو سلوكًا غير متسق بين القراء
- تتم إدارة دورة حياة كائن القاموس المُرجع بواسطة المستند، ولا يجوز للمستدعي تحريره يدويًا، وسيصبح مرجع الكائن غير صالح بعد حفظ المستند