טופס
סקירה כללית
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 | קריאה/כתיבה | כאשר אמת, ערך NeedAppearances של הטופס נדחק כך ש‑Acrobat לא יבנה מחדש את המראה של הווידג’טים בזמן הפתיחה. |
EmulateRequierdGroups | bool | קריאה/כתיבה | כאשר אמת, שלב השטיחה של הטופס מוסיף סימן Required סינתטי עבור ‘requiredGroups’ בסגנון XFA שהגבלת “לפחות אחד נדרש” שלה לא מולאה. |
Count | int | קריאה | מקבל את הספירה. |
RadioGroups | IReadOnlyList<RadioButtonGroup> | קריאה | כל קבוצות כפתורי הרדיו בטופס. |
SignaturesExist | bool | קריאה/כתיבה | אמת אם קיים שדה חתימה עם מילון חתימה /V שאינו ריק בטופס זה. |
Type | FormType | קריאה/כתיבה | סוג הטופס (Standard, Static, Dynamic). |
IsXfa | bool | קריאה | האם טופס זה הוא טופס XFA. |
XFA | XFA? | קריאה | גישה ל‑XFA שמחשיפה את חבילות ה‑XML הבסיסיות (תבנית, מערכי נתונים, …). |
HasXfa | bool | קריאה | אמת כאשר הטופס מכיל חלק XFA. |
AutoRecalculate | bool | קריאה/כתיבה | כאשר אמת, מחשב מחדש שדות מחושבים בכל שינוי של תלות. |
AutoRestoreForm | bool | קריאה/כתיבה | כאשר אמת, הטופס משחזר אוטומטית את ערכי ברירת המחדל שלו באיפוס. |
CalculatedFields | IEnumerable<Field>? | קריאה/כתיבה | סדר השדות המשמש להפעלת מעברי חישוב. |
DefaultAppearance | Aspose.Pdf.Annotations.DefaultAppearance | קריאה/כתיבה | המראה ברירת המחדל המיושם לשדות שאין להם /DA משלהם. |
DefaultResources | Aspose.Pdf.Resources? | קריאה | משאבי גופן / מרחב צבע ברירת המחדל בהם משתמש הטופס. |
IsSynchronized | bool | קריאה | האם האוסף הבסיסי בטוח לשימוש מרובה תהליכים. |
NeedsRendering | bool | קריאה | אמת כאשר לטופס מוגדר דגל NeedsAppearances. |
RemovePermission | bool | קריאה/כתיבה | כאשר אמת, ביטי ההרשאות של המסמך מוסרים לפני השמירה. |
SignaturesAppendOnly | bool | קריאה/כתיבה | כאשר אמת, הכותב מתעלם משינויים שמדלגים על חתימה. |
SyncRoot | object | קריאה | אובייקט השורש לסינכרון עבור IsSynchronized. |
שיטות
| Signature | תיאור |
|---|---|
Form(document: Document) | בנה Form הקשור למסמך. |
Delete(fieldName: string) | מחק שדה טופס לפי שם. |
Add(field: Field) | הוסף שדה ל-Form בעמוד המוגדר. |
Add(field: Field, pageNumber: int) | השדה להוספה. |
findField(fullName: string) | חפש שדה לפי שם; מחזיר null אם לא נמצא. |
FindField(fullName: string) | כינוי PascalCase של findField. |
ToObject() | ייצא את כל ערכי השדות כמילון (שם שדה → ערך). |
HasField(fieldName: string) | True אם קיים שדה עם השם המלא הנתון ב-AcroForm. |
HasField(fieldName: string, searchChildren: bool) | True אם קיים שדה עם השם הנתון. |
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) | העתק שדה לתוך ה-Form תחת שם חלקי חדש, וקשר את הווידג’ט(ים) שלו ל-pageNumber. |
AddFieldAppearance(field: Field, pageNumber: int, rect: Rectangle) | הוסף מראה ווידג’ט חדש לשדה בעמוד ספציפי בתוך ריבוע. |
AssignXfa(xml: XmlDocument) | החלף את מערכי הנתונים XFA מה-XmlDocument הנתון. |
CopyTo(array: Field[], index: int) | העתק שדות למערך שסופק החל מאינדקס. |
Delete(field: Field) | הסר את השדה שסופק מה-Form. |
ExportToJson(stream: Stream) | סיריאליזציה של שדות ה-Form ל-JSON דרך הזרם שסופק. |
ExportToJson(fileName: string) | סיריאליזציה של שדות ה-Form ל-JSON בקובץ. |
ExportToJson(stream: Stream, options: ExportFieldsToJsonOptions?) | סיריאליזציה של שדות ה-Form ל-JSON דרך הזרם שסופק. |
ExportToJson(fileName: string, options: ExportFieldsToJsonOptions?) | סיריאליזציה של שדות ה-Form ל-JSON בקובץ. |
GetFieldsInRect(rect: Rectangle) | החזר את השדות החוצים את הריבוע שסופק. |
HasField(field: Field) | True כאשר השדה שסופק שייך ל-Form זה. |
ImportFromJson(stream: Stream) | קרא ערכי שדות טופס מזרם JSON והחל אותם. |
ImportFromJson(fileName: string) | קרא ערכי שדות טופס מקובץ JSON והחל אותם. |
MakeFormAnnotationsIndependent(page: Page) | נתק אנוטציות טופס מעץ השדות כדי שניתן יהיה להעביר אותן בין עמודים באופן עצמאי. |
RemoveFieldAppearance(field: Field, appearanceIndex: int) | הסר ערך מראה ספציפי משדה. |
