THotPDF.AddLoadedComboBox Method
يضيف صندوق تحرير وسرد (حقل اختيار منسدل مع ضبط علم Combo) إلى صفحة من صفحات المستند المحمّل ويسجله في AcroForm. ويعرض تدفق المظهر القيمة المختارة
الإعلان
function AddLoadedComboBox(PageIndex: Integer; X1, Y1, X2, Y2: Single; const AFieldName, AValue: AnsiString; const AOptions: array of AnsiString): Integer;وحدة
HPDFDoc
المعاملات
| الاسم | الغرض |
|---|---|
PageIndex | فهرس الصفحة المحمّلة المستقبِلة للأداة (widget) بدءًا من الصفر |
X1 | الحافة اليسرى لمستطيل الأداة في فضاء مستخدم PDF (بالنقاط، والأصل في الزاوية السفلية اليسرى للصفحة) |
Y1 | الحافة السفلية لمستطيل الأداة في فضاء مستخدم PDF |
X2 | الحافة اليمنى لمستطيل الأداة في فضاء مستخدم PDF |
Y2 | الحافة العليا لمستطيل الأداة في فضاء مستخدم PDF |
AFieldName | اسم الحقل الجديد؛ ولا يجوز أن يكون موجودًا مسبقًا في النموذج المحمّل |
AValue | الخيار المختار؛ فارغ لعدم وجود اختيار |
AOptions | الخيارات المعروضة في القائمة المنسدلة |
القيمة المُعادة
فهرس الحقل الجديد لاستخدامه مع أساليب حقول النماذج المحمّلة الأخرى، أو -1 عندما يكون PageIndex خارج المدى
ملاحظات الاستخدام
- استخدم هذه الواجهة في سير عمل هندسة الصفحة قبل إنهاء كائن الصفحة أو المورد أو الحقل أو الفهرس المتأثر
- حافظ على ثبات أسماء الكائنات وأسماء الحقول وأسماء الموارد والمقابض المعادة حتى يُنهى المستند
- قد تكون مراجع كائنات المستند المحمّل غير مباشرة؛ حُلّ المصفوفات والقواميس أو التدفقات قبل فحص القيم المتداخلة