العمل مع حقول الاستمارة
A document that contains fill-in blanks (fields) is known as a form. على سبيل المثال، يمكنك إنشاء استمارة تسجيل في Microsoft Word التي تستخدم قوائم الهبوط التي يمكن للمستعملين أن يختاروا منها القيود. The Form الميدان هو موقع يخزن فيه نوع معين من البيانات، مثل الاسم أو العنوان. حقول الاستمارة Microsoft Word وتشمل مدخلات النص، والجمعيات، وصناديق التحقق.
يمكنك استخدام حقول الاستمارة في مشروعك إلى “التواصل” مع مستخدميك. على سبيل المثال، تخلقين وثيقة محمية محتواها لكن فقط شكل الحقول قابل للتجزئة ويمكن للمستعملين أن يدخلوا البيانات في مجالات الشكل وأن يقدموا الوثيقة. تطبيقك الذي يستخدم Aspose.Words يمكن استرجاع البيانات من حقول الشكل ومعالجتها
وضع الحقول في الوثيقة عن طريق الشفرة أمر سهل. DocumentBuilder لديها طرق خاصة لإدراجها، واحدة لكل شكل ميداني. ويقبل كل من هذه الأساليب بارامتر خيط يمثل اسم ميدان الشكل. الاسم يمكن أن يكون خيط فارغ. إذا حددتم اسماً لميدان الاستمارة، فإن علامة كتابية تُنشأ تلقائياً بنفس الاسم.
Insert Form Fields
حقول الاستمارة هي حالة معينة من حقول الكلمات التي تسمح “التفاعل” مع المستخدم. حقول الاستمارة Microsoft Word بما في ذلك صندوق النسيج و صندوق الدمج و صندوق الشيكات
DocumentBuilder يوفّر طرائق خاصة لإدراج كل نوع من أنواع مجالات الاستمارة في الوثيقة: insertTextInput, insertCheckBox أو insertComboBox.
ويبيّن المثال الرمزي التالي كيف يُدرَج حقل نموذجي في وثيقة:
يدرج النص
استخدام يدرج ما يلي: النص طريقة لإدراج نص في الوثيقة.
ويبيّن المثال الرمزي التالي كيفية إدراج شكل مدخلات نصية في وثيقة:
ضع صندوق الشيكات
اتصل يدرج الرمز لإدراج صندوق شيك في الوثيقة.
ويبيّن المثال الرمزي التالي كيف يُدرَج حقل نموذجي في وثيقة:
ضع صندوق كومبو
اتصل يدرج ما يلي:ComboBox لإدراج صندوق في الوثيقة.
ويبيّن المثال الرمزي التالي كيفية إدخال شكل كومبو بوكس في وثيقة:
حقول الاستمارة
A collection of form fields is represented by the FormFieldCollection الطبقة التي يمكن استرجاعها باستخدام Range.getFormFields ملكية وهذا يعني أنه يمكنك الحصول على حقول الاستمارة الواردة في أي وثيقة تتضمن الوثيقة نفسها.
ويبين المثال الرمزي التالي كيفية الحصول على مجموعة من مجالات الشكل:
يمكنك الحصول على حقل شكلي معين بمؤشره أو إسمه
ويبين المثال الرمزي التالي كيفية الوصول إلى الحقول:
The FormField الخواص تسمح لك بالعمل بإسم ميداني، نوع، ونتيجة
ويبين المثال الرمزي التالي كيفية العمل بإسم ميداني من نوع إلى آخر، ونتيجة لذلك: