עבודה עם שדות טפסים

מסמך המכיל ריקות מלא (שדות) ידוע כצורה. לדוגמה, באפשרותך ליצור טופס רישום Microsoft Word זה משתמש ברשימות נפילה שממנו משתמשים יכולים לבחור ערכים. The The The Form שדה הוא מיקום שבו סוג מסוים של נתונים, כגון שם או כתובת, נשמר. שדות טופס Microsoft Word כולל קלט טקסט, combobox ו Checkbox.

אתה יכול להשתמש שדות טופס בפרויקט שלך כדי “לתקשר” עם המשתמשים שלך. לדוגמה, אתה יוצר מסמך שהתוכן שלו מוגן, אבל רק שדות צורה ניתן לערוך. המשתמשים יכולים להיכנס לנתונים בשדות הטופס ולמסור את המסמך. היישום שלך המשתמש Aspose.Words ניתן לשחזר נתונים משדות הטופס ולעבד אותו.

יצירת שדות לתוך המסמך באמצעות קוד היא קלה. DocumentBuilder יש שיטות מיוחדות להוסיף אותם, אחד לכל סוג שדה צורה. כל אחת מהשיטות מקבלת פרמטר מיתר המייצג את השם של שדה הטופס. השם יכול להיות מיתר ריק. עם זאת, אם אתה מציין שם עבור שדה הטופס, סימן ספר נוצר באופן אוטומטי עם אותו שם.

הקמת שדות

שדות טפסים הם מקרה מסוים של שדות Word המאפשר “פעולה” עם המשתמש. שדות טופס Microsoft Word כולל תיבת טקסט, תיבת קומבו ו- Checkbox.

DocumentBuilder מספק שיטות מיוחדות להכניס כל סוג של שדה טופס לתוך המסמך: insert_text_input, insert_check_box, ו insert_combo_box. שים לב שאם אתה מציין שם עבור שדה הטופס, סימן ספר נוצר באופן אוטומטי עם אותו שם.

הדוגמה הבאה של הקוד מראה כיצד להכניס שדה טופס תיבת קומבול לתוך מסמך:

הכנס הודעת טקסט

השתמש insert_text_input שיטה להכניס תיבת טקסט לתוך המסמך.

דוגמה הקוד הבא מראה כיצד להכניס שדה טופס קלט טקסט לתוך מסמך:

doc = aw.Document()
builder = aw.DocumentBuilder(doc)

builder.insert_text_input("TextInput", aw.fields.TextFormFieldType.REGULAR, "", "Hello", 0)
        
doc.save(docs_base.artifacts_dir + "WorkingWithFormFields.document_builder_insert_text_input_form_field.docx")

תגית: Check Box

Call insert_check_box להכניס תיבת צ’ק לתוך המסמך.

הדוגמה הבאה של הקוד מראה כיצד להכניס שדה טופס Checkbox לתוך מסמך:

doc = aw.Document()
builder = aw.DocumentBuilder(doc)

builder.insert_check_box("CheckBox", True, True, 0)
        
doc.save(docs_base.artifacts_dir + "WorkingWithFormFields.document_builder_insert_check_box_form_field.docx")

תגית: Combo Box

Call insert_combo_box להכניס קומבווקס לתוך המסמך.

לדוגמה הקוד הבא מראה כיצד להכניס שדה טופס Combobox לתוך מסמך:

doc = aw.Document()
builder = aw.DocumentBuilder(doc)

items =  ["One", "Two", "Three"] 
builder.insert_combo_box("DropDown", items, 0)

doc.save(docs_base.artifacts_dir + "WorkingWithFormFields.document_builder_insert_combo_box_form_field.docx")

טופס שדות

אוסף של שדות צורה מיוצג על ידי FormFieldCollection שיעור שניתן לשחזר באמצעות form_fields רכוש. זה אומר שאתה יכול להשיג שדות טופס הכלולים בכל מסמך כולל המסמך עצמו.

אתה יכול לקבל שדה טופס מסוים על ידי אינדקס או שם.

דוגמה לקוד הבא מראה כיצד לגשת לשדות צורה:

The The The FormField תכונות מאפשרות לך לעבוד עם שם שדה טופס, סוג ותוצאה.

הדוגמה הקודית הבאה מראה כיצד לעבוד עם שם שדה צורה, סוג ותוצאה:

עיצוב שדות

The The The font רכוש FormField מאפשר יישום פונטו פורמט ל FormField ככלל, כולל ערך השדה.

הדוגמה הקודית הבאה מראה כיצד ליישם את הגרפיקה FormField: