THotPDF.GetLoadedFormFieldOption Method
يقرأ قيمة التصدير للخيار المحدد في حقل نموذج PDF محمّل، ويعيد في الوقت نفسه نص العرض المقابل عبر معامل إخراج
الإعلان
function GetLoadedFormFieldOption(FieldIndex, OptionIndex: Integer; out ADisplayValue: AnsiString): AnsiString;وحدة
HPDFDoc
المعاملات
| الاسم | الغرض |
|---|---|
FieldIndex | فهرس حقل النموذج المستهدف بدءًا من الصفر |
OptionIndex | فهرس الخيار بدءًا من الصفر في قائمة خيارات الحقل |
ADisplayValue | معامل إخراج يستقبل النص الذي يعرضه الخيار للمستخدم في الواجهة |
ADisplayText | مُدخَل يستخدمه GetLoadedFormFieldOption |
القيمة المُعادة
يُرجع قيمة التصدير (export value) لهذا الخيار، وهي السلسلة التي يتم تمريرها فعليًا إلى الخادم أو FDF عند إرسال النموذج
ملاحظات الاستخدام
- ينطبق على أنواع الحقول الحاملة لقائمة خيارات فقط (مثل ComboBox المنسدل وListBox القائم)، ويُعاد مع الاستدعاء على حقل نص عادي سلسلة فارغة
- يجب أن يبقى OptionIndex في المدى من 0 إلى GetLoadedFormFieldOptionCount - 1، وتجاوز الحدود يثير استثناء
- قد تختلف قيمة التصدير عن نص العرض، فارفع بين الغرضين قبل الإرسال ولا تتعامل مع نص العرض بوصفه محتوى الإرسال