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