نموذج
نظرة عامة
Form هي فئة في Aspose.PDF FOSS لـ .NET.
ترث من: IEnumerable<Aspose.Pdf.Annotations.WidgetAnnotation>.
يمثل النموذج التفاعلي (AcroForm) لمستند PDF.
هذه الفئة توفر 36 طريقة للعمل مع كائنات Form في برامج .NET.
الطرق المتاحة تشمل: Add، AddFieldAppearance، AssignXfa، CopyTo، Delete، ExportFdf، ExportToJson، ExportXfdf، FindByName، FindField، Flatten، Form، و 14 طريقة إضافية.
جميع الأعضاء العامة متاحة لأي تطبيق .NET بعد تثبيت حزمة Aspose.PDF FOSS for .NET.
الخصائص: AutoRecalculate، AutoRestoreForm، CalculatedFields، Count، DefaultAppearance، DefaultResources، و 14 أخرى.
الخصائص
| الاسم | النوع | الوصول | الوصف |
|---|---|---|---|
Fields | Field[] | قراءة | يعيد حقول النموذج كمصفوفة لقطة (Field[] Fields)، بحيث يمكن للمتصلين استخدام .Length وفهرسة المصفوفة. |
IgnoreNeedsRendering | bool | قراءة/كتابة | عند أن تكون true، يتم قمع إدخال NeedAppearances للنموذج بحيث لا يقوم Acrobat بإعادة بناء مظهر الودجت عند الفتح. |
EmulateRequierdGroups | bool | قراءة/كتابة | عند أن تكون true، يضيف خطوة تسوية النموذج علامة Required اصطناعية لمجموعات “requiredGroups” بنمط XFA التي لم يتحقق فيها شرط وجود عنصر واحد على الأقل مطلوب. |
Count | int | قراءة | يحصل على العدد. |
RadioGroups | IReadOnlyList<RadioButtonGroup> | قراءة | جميع مجموعات أزرار الراديو في النموذج. |
SignaturesExist | bool | قراءة/كتابة | True إذا كان هناك أي حقل توقيع يحتوي على قاموس توقيع /V غير فارغ في هذا النموذج. |
Type | FormType | قراءة/كتابة | نوع النموذج (Standard, Static, Dynamic). |
IsXfa | bool | قراءة | ما إذا كان هذا النموذج نموذج XFA. |
XFA | XFA? | قراءة | مستخرج XFA الذي يكشف حزم XML الأساسية (القالب، مجموعات البيانات، …). |
HasXfa | bool | قراءة | True عندما يحتوي النموذج على جزء XFA. |
AutoRecalculate | bool | قراءة/كتابة | عند أن تكون true، يتم إعادة حساب الحقول المحسوبة كلما تغيرت إحدى الاعتمادات. |
AutoRestoreForm | bool | قراءة/كتابة | عند أن تكون true، يعيد النموذج تلقائيًا قيمه الافتراضية عند إعادة الضبط. |
CalculatedFields | IEnumerable<Field>? | قراءة/كتابة | ترتيب الحقول المستخدم لتوجيه عمليات الحساب. |
DefaultAppearance | Aspose.Pdf.Annotations.DefaultAppearance | قراءة/كتابة | المظهر الافتراضي المطبق على الحقول التي لا تحمل /DA الخاص بها. |
DefaultResources | Aspose.Pdf.Resources? | قراءة | خط / موارد مساحة اللون الافتراضية المستخدمة في النموذج. |
IsSynchronized | bool | قراءة | ما إذا كانت المجموعة الأساسية آمنة للخطوط المتعددة. |
NeedsRendering | bool | قراءة | True عندما يكون للنموذج علم NeedsAppearances مفعلاً. |
RemovePermission | bool | قراءة/كتابة | عند أن تكون true، يتم حذف بتات أذونات المستند قبل الحفظ. |
SignaturesAppendOnly | bool | قراءة/كتابة | عند أن تكون true، يتجاهل الكاتب التعديلات التي تتجاوز التوقيع. |
SyncRoot | object | قراءة | كائن الجذر للمزامنة لـ IsSynchronized. |
الطرق
| Signature | Description |
|---|---|
Form(document: Document) | إنشاء نموذج مرتبط بالمستند. |
Delete(fieldName: string) | حذف حقل نموذج حسب الاسم. |
Add(field: Field) | إضافة حقل إلى النموذج في الصفحة المحددة. |
Add(field: Field, pageNumber: int) | الحقل المراد إضافته. |
findField(fullName: string) | البحث عن حقل بالاسم؛ يُعيد null إذا لم يُعثر عليه. |
FindField(fullName: string) | اسم مستعار PascalCase للدالة findField. |
ToObject() | تصدير جميع قيم الحقول كقاموس (اسم الحقل → القيمة). |
HasField(fieldName: string) | صحيح إذا كان هناك حقل بالاسم الكامل المحدد موجودًا في AcroForm. |
HasField(fieldName: string, searchChildren: bool) | صحيح إذا كان هناك حقل بالاسم المحدد موجودًا. |
FindByName(fullName: string) | العثور على حقل بالاسم الكامل، أو بمسار XFA للنماذج الثابتة XFA. |
GetXfaDatasetsXml() | الحصول على XML لمجموعات بيانات XFA، أو null إذا لم يكن نموذج XFA. |
GetXfaFieldValue(path: string) | الحصول على قيمة حقل XFA عبر مسار نقطي في XML لمجموعات البيانات. |
SetXfaFieldValue(path: string, value: string) | تعيين قيمة حقل XFA عبر مسار نقطي في XML لمجموعات البيانات. |
SetXfaFieldValues(values: IReadOnlyList<KeyValuePair<string, string>>) | تعيين عدة قيم حقول XFA في دورة واحدة لتحليل/تسلسل مجموعات البيانات. |
Flatten() | تسوية جميع حقول النموذج — تحويل مظهرها البصري إلى محتوى الصفحة وإزالة النموذج التفاعلي. |
Flatten(document: Document) | تسوية جميع حقول النموذج — تحويل مظهرها البصري إلى محتوى الصفحة وإزالة النموذج التفاعلي. |
ExportFdf() | تصدير بيانات حقول النموذج بصيغة FDF (Forms Data Format) وفقًا لمواصفة PDF §12.7.7. |
ImportFdf(fdfData: byte[]) | استيراد بيانات حقول النموذج من بايتات FDF. |
ExportXfdf() | تصدير بيانات حقول النموذج بصيغة XFDF (XML Forms Data Format). |
ImportXfdf(xfdfXml: string) | استيراد بيانات حقول النموذج من سلسلة XML بصيغة XFDF. |
GetEnumerator() | يستدعي GetEnumerator على هذه المثيلة من Form. |
Add(field: Field, partialName: string, pageNumber: int) | نسخ الحقل إلى النموذج تحت اسم جزئي جديد، وربط عنصر(عناصر) الواجهة بالصفحة pageNumber. |
AddFieldAppearance(field: Field, pageNumber: int, rect: Rectangle) | إضافة مظهر واجهة جديد إلى حقل في صفحة محددة داخل مستطيل. |
AssignXfa(xml: XmlDocument) | استبدال مجموعات بيانات XFA من XmlDocument المقدم. |
CopyTo(array: Field[], index: int) | نسخ الحقول إلى المصفوفة المقدمة بدءًا من الفهرس. |
Delete(field: Field) | إزالة الحقل المقدم من النموذج. |
ExportToJson(stream: Stream) | تحويل حقول النموذج إلى JSON عبر الدفق المقدم. |
ExportToJson(fileName: string) | تحويل حقول النموذج إلى JSON في ملف. |
ExportToJson(stream: Stream, options: ExportFieldsToJsonOptions?) | تحويل حقول النموذج إلى JSON عبر الدفق المقدم. |
ExportToJson(fileName: string, options: ExportFieldsToJsonOptions?) | تحويل حقول النموذج إلى JSON في ملف. |
GetFieldsInRect(rect: Rectangle) | إرجاع الحقول التي تتقاطع مع المستطيل المقدم. |
HasField(field: Field) | صحيح عندما يكون الحقل المقدم تابعًا لهذا النموذج. |
ImportFromJson(stream: Stream) | قراءة قيم حقول النموذج من دفق JSON وتطبيقها. |
ImportFromJson(fileName: string) | قراءة قيم حقول النموذج من ملف JSON وتطبيقها. |
MakeFormAnnotationsIndependent(page: Page) | فصل تعليقات النموذج عن شجرة الحقول بحيث يمكن نقلها بين الصفحات بشكل مستقل. |
RemoveFieldAppearance(field: Field, appearanceIndex: int) | إزالة إدخال مظهر محدد من حقل. |
