ویرایشگر فرم
نمای کلی
FormEditor یک کلاس در Aspose.PDF FOSS برای .NET است.
ارثبری میکند از: IDisposable.
واسط برای عملیات فرم: پر کردن فیلدها، صافسازی فرمها، وارد/صادر کردن دادهها.
این کلاس 64 متد برای کار با اشیاء FormEditor در برنامههای .NET فراهم میکند.
متدهای موجود شامل: AddCheckBox، AddField، AddFieldScript، AddListItem، AddSubmitBtn، AddTextField، BindPdf، CheckField، Close، CopyInnerField، CopyOuterField، DecorateField، و 34 متد دیگر.
تمام اعضای عمومی پس از نصب بسته Aspose.PDF FOSS for .NET برای هر برنامه .NET قابل دسترسی هستند.
ویژگیها: ConvertTo، DestFileName، DestStream، ExportItems، Facade، Items، و 6 مورد دیگر.
ویژگیها
| نام | نوع | دسترسی | توضیح |
|---|---|---|---|
SrcFileName | string? | Read/Write | مسیر فایل منبع که توسط سازنده بدون پارامتر + جریان Save استفاده میشود. |
SrcStream | Stream? | Read/Write | جریان منبع که توسط سازنده بدون پارامتر + جریان Save استفاده میشود. |
DestFileName | string? | Read/Write | مسیر فایل مقصد که توسط Save() بدون پارامتر نوشته میشود. |
DestStream | Stream? | Read/Write | جریان مقصد که توسط Save() بدون پارامتر نوشته میشود. |
ConvertTo | PdfFormat | Read/Write | نسخه هدف PDF/A یا PDF برای خروجی ذخیرهشده. |
Facade | FormFieldFacade | Read/Write | ظاهر بصری که توسط AddField و DecorateField() اعمال میشود. |
Items | string[]? | Read/Write | فهرست پیشفرض آیتمها که توسط AddField هنگام ایجاد فیلدهای ListBox / ComboBox استفاده میشود. |
ExportItems | string[][]? | Read/Write | جفتهای مقدار‑صادرات که با Items جفت شدهاند. |
RadioButtonItemSize | double | Read/Write | طول لبه آیتم رادیو باتن (به نقطه) که هنگام چیدمان یک گروه رادیویی استفاده میشود. |
RadioGap | float | Read/Write | فاصله (به نقطه) بین آیتمهای رادیو باتن در یک گروه. |
RadioHoriz | bool | Read/Write | زمانی که true باشد، آیتمهای رادیو باتن به صورت افقی چیده میشوند؛ در غیر این صورت به صورت عمودی. |
SubmitFlag | SubmitFormFlag | Read/Write | قالب ارسال که توسط AddSubmitBtn و SetSubmitFlag استفاده میشود. |
روشها
| Signature | Description |
|---|---|
FormEditor() | سازنده پیشفرض برای API بدون حالت مبتنی بر byte[] |
FormEditor(document: Document) | ویرایشگر را به یک سند برای عملیات درجا متصل کنید |
FormEditor(document: Document, destStream: Stream) | یک سند را متصل کنید و یک جریان خروجی را برای Save بدون پارامتر پیشپیکربندی کنید |
FormEditor(document: Document, destFileName: string) | یک سند را متصل کنید و مسیر فایل خروجی را برای Save بدون پارامتر پیشپیکربندی کنید |
FormEditor(srcStream: Stream, destStream: Stream) | از یک جریان ورودی باز کنید، در زمان Save به یک جریان خروجی مینویسد |
FormEditor(srcFileName: string, destFileName: string) | از یک فایل ورودی باز کنید، در زمان Save به یک فایل خروجی مینویسد |
BindPdf(path: string) | یک فایل PDF را با مسیر برای ویرایش متصل کنید |
BindPdf(pdfData: byte[]) | یک PDF را از بافر بایت متصل کنید |
BindPdf(stream: Stream) | یک PDF را از یک جریان متصل کنید |
BindPdf(document: Document) | یک PDF را از یک Document که قبلاً باز شده است متصل کنید |
Save(path: string) | سند متصل شده را به مسیر فایل ذخیره کنید |
Save(destStream: Stream) | سند متصل شده را به یک جریان ذخیره کنید |
Save() | سند متصل شده را به مقصد پیکربندیشده (DestFileName یا DestStream) ذخیره کنید |
Close() | سند متصل شده را ببندید و آزاد کنید |
Dispose() | متد Dispose را بر روی این نمونه FormEditor فراخوانی میکند |
SetField(fieldName: string, value: string) | مقدار یک فیلد را بر اساس نام تنظیم کنید |
CheckField(fieldName: string) | یک فیلد چکباکس را بر اساس نام علامت بزنید |
UncheckField(fieldName: string) | یک فیلد چکباکس را بر اساس نام علامتزدایی کنید |
AddTextField(fieldName: string, pageNumber: int, llx: double, lly: double, urx: double, ury: double) | یک فیلد متنی به سند متصل شده اضافه کنید |
AddCheckBox(fieldName: string, pageNumber: int, llx: double, lly: double, urx: double, ury: double, isChecked: bool) | یک فیلد چکباکس به سند متصل شده اضافه کنید |
AddField(fieldType: FieldType, fieldName: string, pageNum: int, llx: float, lly: float, urx: float, ury: float) | فیلدی از نوع fieldType داده شده در مستطیل درخواستشده روی pageNum اضافه کنید |
AddField(fieldType: FieldType, fieldName: string, initValue: string?, pageNum: int, llx: float, lly: float, urx: float, ury: float) | فیلدی با مقدار اولیه (فیلدهای متنی و جعبههای ترکیبی) اضافه کنید |
AddListItem(fieldName: string, itemName: string) | یک آیتم واحد به فیلد ListBox / ComboBox اضافه کنید |
AddListItem(fieldName: string, exportName: string[]) | یک آیتم واحد با جفت مقدار‑صادرات (نمایش، صادرات) اضافه کنید |
DelListItem(fieldName: string, itemName: string) | یک آیتم واحد را از فیلد ListBox / ComboBox حذف کنید |
AddSubmitBtn(fieldName: string, page: int, label: string, url: string, llx: float, lly: float, urx: float, ury: float) | یک دکمه Submit اضافه کنید |
AddFieldScript(fieldName: string, script: string) | یک اسکریپت عمل JavaScript را به فیلد پیوست کنید |
SetFieldScript(fieldName: string, script: string) | اسکریپت عمل JavaScript فیلد را جایگزین کنید |
CopyInnerField(fieldName: string, newFieldName: string, pageNum: int) | یک فیلد را درون سند متصل شده به صفحه دیگری کپی کنید |
CopyInnerField(fieldName: string, newFieldName: string, pageNum: int, abscissa: float, ordinate: float) | یک فیلد را درون سند متصل شده به صفحه دیگری در مختصات دادهشده کپی کنید |
CopyOuterField(srcFileName: string, fieldName: string) | فیلدی را از فایل PDF دیگر به سند متصل شده در همان موقعیت کپی کنید |
CopyOuterField(srcFileName: string, fieldName: string, pageNum: int) | فیلدی را از فایل PDF دیگر به سند متصل شده در صفحه مشخصی کپی کنید |
CopyOuterField(srcFileName: string, fieldName: string, pageNum: int, abscissa: float, ordinate: float) | فیلدی را از فایل PDF دیگر در مختصات صریح کپی کنید |
DecorateField() | Facade را بر تمام فیلدهای سند اعمال کنید |
DecorateField(fieldType: FieldType) | Facade را بر تمام فیلدهای نوع دادهشده اعمال کنید |
DecorateField(fieldName: string) | Facade را بر یک فیلد نامدار واحد اعمال کنید |
ResetFacade() | تمام خصوصیات Facade را بازنشانی کنید |
ResetInnerFacade() | نام مستعار برای ResetFacade که فراخوانندگان nested‑facade را پوشش میدهد |
MoveField(fieldName: string, llx: float, lly: float, urx: float, ury: float) | جعبه مرزی فیلد را جابجا کنید |
RenameField(fieldName: string, newFieldName: string) | نام یک فیلد فرم را تغییر دهید |
RemoveField(fieldName: string) | فیلدی را بر اساس نام حذف کنید |
RemoveFieldAction(fieldName: string) | عمل پیوستشده به فیلد را حذف کنید |
SetFieldAlignment(fieldName: string, alignment: int) | تراز افقی مقدار فیلد را تنظیم کنید |
SetFieldAlignmentV(fieldName: string, alignment: int) | تراز عمودی مقدار فیلد را تنظیم کنید |
SetFieldAppearance(fieldName: string, flags: AnnotationFlags) | پرچمهای نمایش / فقط‑خواندنی / الزامی را بر فیلد تنظیم کنید |
GetFieldAppearance(fieldName: string) | پرچمهای نمایش / فقط‑خواندنی / الزامی فیلد را برگردانید |
SetFieldAttribute(fieldName: string, flag: PropertyFlag) | ReadOnly / Required / NoExport را تنظیم کنید |
SetFieldCombNumber(fieldName: string, combNumber: int) | تعداد سلولهای comb را برای فیلد متنی تنظیم کنید (PDF 1.5+) |
SetFieldLimit(fieldName: string, fieldLimit: int) | حداکثر تعداد کاراکترهای فیلد متنی را بر اساس نام تنظیم کنید |
SetSubmitFlag(fieldName: string, submitFormFlag: SubmitFormFlag) | پرچم عمل SubmitForm را بر فیلد دکمه تنظیم کنید |
SetSubmitUrl(fieldName: string, url: string) | URL هدف عمل SubmitForm را بر فیلد دکمه تنظیم کنید |
Single2Multiple(fieldName: string) | فیلد متنی تکخطی را به چندخطی تبدیل کنید |
FlattenAllFields() | تمام فیلدهای فرم را در سند متصل شده صاف (Flatten) کنید |
FillFields(input: byte[], fieldValues: Dictionary<string, string>) | فیلدهای فرم را با مقادیر دادهشده پر کنید (نام فیلد → مقدار) |
FillField(input: byte[], fieldName: string, value: string) | یک فیلد فرم را بر اساس نام پر کنید |
FlattenForm(input: byte[]) | فرم را صاف کنید — فیلدها را به عنوان محتوای ثابت رندر کنید و AcroForm را حذف کنید |
GetFieldNames(input: byte[]) | تمام نامهای فیلدهای فرم در سند را دریافت کنید |
GetFieldValue(input: byte[], fieldName: string) | مقدار یک فیلد خاص را دریافت کنید |
GetFieldType(input: byte[], fieldName: string) | نوع یک فیلد خاص را دریافت کنید |
HasForm(input: byte[]) | بررسی کنید آیا سند دارای فرم است یا خیر |
GetFieldCount(input: byte[]) | تعداد کل فیلدهای فرم را دریافت کنید |
ExportFormData(input: byte[]) | دادههای فرم را به صورت یک دیکشنری (نام فیلد → مقدار) صادر کنید |
ImportFormData(input: byte[], data: Dictionary<string, string>) | دادههای فرم را از یک دیکشنری وارد کنید |
RenameField(input: byte[], oldName: string, newPartialName: string) | یک فیلد فرم را در بایتهای ارائهشده تغییر نام دهید |