فرم

فرم

نمای کلی

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 متد دیگر.
تمام اعضای عمومی پس از نصب بسته Aspose.PDF FOSS for .NET برای هر برنامه .NET در دسترس هستند.
ویژگی‌ها: AutoRecalculate، AutoRestoreForm، CalculatedFields، Count، DefaultAppearance، DefaultResources، و 14 مورد دیگر.

ویژگی‌ها

NameTypeAccessDescription
FieldsField[]Readفیلدهای فرم را به‌صورت یک آرایهٔ لحظه‌ای (Field[] Fields) برمی‌گرداند، بنابراین فراخوانندگان می‌توانند از .Length و ایندکس‌گذاری آرایه استفاده کنند.
IgnoreNeedsRenderingboolRead/Writeزمانی که مقدار true باشد، ورودی NeedAppearances فرم سرکوب می‌شود تا Acrobat در زمان باز شدن، ظاهر ویجت‌ها را بازسازی نکند.
EmulateRequierdGroupsboolRead/Writeزمانی که مقدار true باشد، مرحلهٔ صاف‌سازی فرم یک نشانگر مصنوعی Required برای «requiredGroups» به سبک XFA که قید حداقل یک مورد مورد نیاز برآورده نشده است، اضافه می‌کند.
CountintReadتعداد را برمی‌گرداند.
RadioGroupsIReadOnlyList<RadioButtonGroup>Readتمام گروه‌های دکمهٔ رادیویی در فرم.
SignaturesExistboolRead/Writeدر صورتی که هر فیلد امضایی با یک دیکشنری امضای /V غیر‌خالی در این فرم وجود داشته باشد، مقدار true است.
TypeFormTypeRead/Writeنوع فرم (Standard, Static, Dynamic).
IsXfaboolReadاینکه آیا این فرم یک فرم XFA است یا خیر.
XFAXFA?Readدسترس‌ساز XFA که بسته‌های XML زیرین (قالب، مجموعه داده‌ها، …) را افشا می‌کند.
HasXfaboolReadدر صورتی که فرم شامل بخشی XFA باشد، مقدار true است.
AutoRecalculateboolRead/Writeزمانی که true باشد، فیلدهای محاسبه‌شده هر زمان که یک وابستگی تغییر کند، دوباره محاسبه می‌شوند.
AutoRestoreFormboolRead/Writeزمانی که true باشد، فرم به‌صورت خودکار مقادیر پیش‌فرض خود را هنگام Reset بازگردانده می‌کند.
CalculatedFieldsIEnumerable<Field>?Read/Writeترتیب فیلدها که برای هدایت عبورهای محاسبه استفاده می‌شود.
DefaultAppearanceAspose.Pdf.Annotations.DefaultAppearanceRead/Writeظاهر پیش‌فرضی که به فیلدهایی که /DA خود را ندارند اعمال می‌شود.
DefaultResourcesAspose.Pdf.Resources?Readمنابع قلم / فضای رنگ پیش‌فرضی که توسط فرم استفاده می‌شود.
IsSynchronizedboolReadاینکه آیا مجموعهٔ زیرین ایمن برای استفاده در چندین رشته (thread-safe) است یا خیر.
NeedsRenderingboolReadدر صورتی که فرم پرچم NeedsAppearances را تنظیم کرده باشد، مقدار true است.
RemovePermissionboolRead/Writeزمانی که true باشد، بیت‌های مجوز سند قبل از ذخیره‌سازی حذف می‌شوند.
SignaturesAppendOnlyboolRead/Writeزمانی که true باشد، نویسنده تغییراتی که امضا را دور می‌زنند نادیده می‌گیرد.
SyncRootobjectReadشیء ریشهٔ همگام‌سازی برای IsSynchronized.

روش‌ها

SignatureDescription
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 وجود داشته باشد، true برمی‌گرداند.
HasField(fieldName: string, searchChildren: bool)در صورتی که فیلدی با نام داده شده وجود داشته باشد، true برمی‌گرداند.
FindByName(fullName: string)یک فیلد را بر اساس نام کامل آن یا مسیر XFA برای فرم‌های XFA ایستا پیدا کنید.
GetXfaDatasetsXml()XML مجموعه داده‌های XFA را دریافت کنید، یا اگر فرم XFA نیست null برگردانید.
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)در صورتی که فیلد ارائه شده به این فرم تعلق داشته باشد، true برمی‌گرداند.
ImportFromJson(stream: Stream)مقادیر فیلدهای فرم را از یک استریم JSON بخوانید و اعمال کنید.
ImportFromJson(fileName: string)مقادیر فیلدهای فرم را از یک فایل JSON بخوانید و اعمال کنید.
MakeFormAnnotationsIndependent(page: Page)حاشیه‌نویسی‌های فرم را از درخت فیلد جدا کنید تا بتوان آن‌ها را به‌صورت مستقل بین صفحات جابجا کرد.
RemoveFieldAppearance(field: Field, appearanceIndex: int)یک ورودی ظاهر خاص را از فیلد حذف کنید.

همچنین ببینید

 فارسی