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