Робота з полями форм

Документ, який містить заготовки наповнювача (польів) відомий як форму. Наприклад, ви можете створити реєстраційну форму в Microsoft Word Користувачі можуть вибрати записи. Про нас Form поле є розташуванням, де зберігається окремий тип даних, таких як назва або адреса. Форма поля Microsoft Word включає в себе текстовий вхід, комбобокс і прапорець.

Ви можете використовувати поля форми у вашому проекті для “комунікації” з вашими користувачами. Наприклад, ви створюєте документ, вміст якого захищений, але тільки поля форми редагуються. Користувачі можуть ввести дані у вигляді полів і подати документ. Ваше додаток, яке використовує Aspose.Words може отримувати дані з полів форми та обробляти її.

Розміщення форм полів у документ за допомогою коду легко. DocumentBuilder має спеціальні методи для вставки їх, для кожного виду форми. Кожен з методів приймає параметр рядка, що представляє назву поля форми. Назва може бути порожнім рядком. Якщо ви вказали ім’я для поля форми, то закладок автоматично створюється з такою назвою.

Вставки формові поля

Форма поля – це окремий випадок полів Word, що дозволяє “інтеркція” користувачеві. Форма поля Microsoft Word включає в себе текстову скриньку, комбобокс і прапорець.

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")

Вставте прапорець

Дзякуй insert_check_box вставити прапорець в документ.

Приклад коду показує, як вставити поле форми прапорця в документ:

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")

Вставте комбо Box

Дзякуй 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 майно. Це означає, що ви можете отримати поля, що містяться в будь-якому документі, в тому числі сам документ.

Ви можете отримати конкретне поле форми за індексом або назвою.

Приклад коду показує, як використовувати поля:

Про нас FormField властивості дозволяють працювати з іменем поля, типом та результатом.

Приклад коду показує, як працювати з ім’ям поля, типом та результатом:

Формат форми поля

Про нас font нерухомість FormField дозволяє застосувати форматування шрифту до FormField в цілому, включаючи значення поля.

Приклад наступного коду показує, як застосувати форматування шрифтів до FormField: