THotPDF.GetLoadedFormFieldOptionCount Method
عندما ينتمي حقل نموذج المستند المُحمّل المحدد إلى عنصر تحكم بخيارات مثل مربع تحرير وسرد منسدل (ComboBox) أو مربع قائمة (ListBox)، فإنه يرجع العدد المحدد للخيارات المتضمنة في ذلك العنصر التحكم.
الإعلان
function GetLoadedFormFieldOptionCount(FieldIndex: Integer): Integer;وحدة
HPDFDoc
المعاملات
| الاسم | الغرض |
|---|---|
FieldIndex | فهرس عنصر تحكم النموذج المستهدف في مصفوفة حقول المستند (بدءًا من 0). |
القيمة المُعادة
يُرجع إجمالي عدد العناصر الفرعية أو الخيارات المتاحة التي يحملها هذا الحقل. وإذا لم ينتمِ إلى نوع عنصر تحكم الخيارات، فقد يرجع 0.
ملاحظات الاستخدام
- يتيح هذا الـ API قراءة عدد خيارات القائمة المنسدلة بدقة استعدادًا لتجولها أو تصديرها أو تعبئتها
- تأكد من التحقق مما إذا كان نوع عنصر التحكم هو مربع تحرير وسرد قبل التنفيذ.
- قد تكون مراجع كائنات المستند المحمّل غير مباشرة؛ فاحصر المصفوفات أو القواميس أو التدفقات قبل فحص القيم المتداخلة