THotPDF.EnsureLoadedAcroForm Method
تأكد من وجود قاموس AcroForm لـ PDF المُحمّل وإمكانية الوصول إليه، وإذا كان المستند لا يحتوي بعد على إدخال AcroForm، فسيتم إنشاؤه تلقائيًا ويُرجع كائن القاموس المقابل
الإعلان
function EnsureLoadedAcroForm: THPDFDictionaryObject;
وحدة
HPDFDoc
القيمة المُعادة
| الاسم | الغرض |
|---|---|
| لا يعرض هذا العضو معاملات صريحة | |
قيمة الإرجاع
يعيد نسخة THPDFDictionaryObject تمثل قاموس AcroForm؛ وإذا خلا المستند أصلًا من AcroForm أعاد كائن القاموس المُنشأ حديثًا
ملاحظات الاستخدام
- لا بد قبل استدعاء هذا التابع من تحميل مستند PDF بنجاح عبر LoadFromFile أو LoadFromStream، وإلا كان السلوك غير معرف
- كائن القاموس المُرجع مملوك للمستند، ولا يجوز للمستدعي تحريره يدويًا، ولا الاستمرار في الإشارة إليه بعد إغلاق المستند
- لإضافة حقل إلى نموذج قائم، استدعِ هذا التابع أولًا للحصول على قاموس AcroForm ثم أنشئ أداة الحقل عبر CreateLoadedFieldWidget